Appearance
Recurring Payments
Сервис рекуррентных платежей позволяет автоматически списывать средства с карты Покупателя без его участия.
После успешной инициализации платежа через метод Authorization , система создаёт задачу на последующие списания по подписке.
Если вторая или последующая попытка списания завершается с ошибкой, система запускает повторные попытки по следующему расписанию:
Интервалы обновлений и попыток списания:
- Каждые 5 минут:
- обновление статуса платежей по подпискам;
- обновление статуса подписки (если статус "новая" или "деактивирована").
- Каждый 1 час:
- повторные попытки списания платежей по подписке.
Общее время повторных попыток:
- в течение 48 часов с момента первой неудачной попытки каждый час.
- Если в течение этого времени платёж не будет успешно завершён, он получает финальный статус
error, и дальнейшие попытки не предпринимаются.
Параметры запроса
URL https://ps.airbapay.kz/acquiring-api/api/v2/subscription
Method POST
| Параметр | Тип | Описание |
|---|---|---|
| amount* | float64 | Сумма платежа. Пример: 10000 |
| currency* | string | Валюта платежа. Пример: KZT |
| description | string | Описание платежа. Пример: Абонемент на плавание |
| email* | string | Почта клиента. Пример: client@email.com |
| phone* | string | Телефон клиента. Пример: 77011234567 |
| language* | string | Язык интерфейса. Допустимые значения ru, en, kz |
| account_id* | string | Аккаунт клиента в системе мерчанта. Пример: 77011234567 |
| start_date* | string | Дата начала подписки. Формат: YYYY-MM-DD |
| frequency* | string | Периодичность списаний. Допустимые значения: daily, weekly, monthly, yearly |
| success_back_url* | string | URL возврата в магазин при успехе |
| failure_back_url* | string | URL возврата в магазин при ошибке |
| success_callback* | string | URL вебхука при успехе |
| failure_callback* | string | URL вебхука при ошибке |
Пример запроса:
json
{
"amount": 10000,
"currency": "KZT",
"description": "Абонемент на плавание",
"email": "admin@airbapay.kz",
"phone": "+77077000000",
"language": "ru",
"account_id": "77077000000",
"start_date": "2025-03-12",
"frequency": "yearly",
"success_back_url": "https://airba.kz",
"failure_back_url": "https://airba.kz",
"success_callback": "https://airbakz.kz",
"failure_callback": "https://airbakz.kz"
}Параметр ответа при коде состояния HTTP 200
| Параметр | Тип | Описание |
|---|---|---|
| payment_id | string | ID платежа в Airba Pay. Пример: 67d1f4dd392e2454aff53097 |
| subscription_id | string | ID подписки в Airba Pay. Пример: 67d1f4dd392e2454aff53096 |
| redirect_url | string | URL платежной формы для ввода данных карты |
json
{
"payment_id": "67d1f4dd392e2454aff53097",
"subscription_id": "67d1f4dd392e2454aff53096",
"redirect_url": "https://spf.airbapay.kz/ru/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDE4MjAxNTcsImlzX3JlZnJlc2giOmZhbHNlLCJwYXltZW50X2lkIjoiNjdkMWY0ZGQzOTJlMjQ1NGFmZjUzMDk3IiwidGVybWluYWxfaWQiOiI2NDIxNmU3Y2NjNGE0OGRiMDYwZGQ2ODkifQ.UEFEo0SB_bpAjZJjsi9ldXWqWCOSY8n9_WsRNTZMj60"
}