Настройте подписку один раз — и система сама выставляет счёт в Kaspi Pay каждый период. Клиент платит привычным приложением Kaspi. Регулярные счета, повторные попытки при неоплате, пауза и отмена — через простой API.
Рекуррентные платежи — это автоматические регулярные счета в Kaspi Pay. Продавец настраивает подписку один раз, а дальше система сама выставляет счёт каждый период, и клиент оплачивает привычным Kaspi. Так работают регулярные платежи каспи и подписки каспи: не нужно вручную выставлять счёт каждый месяц. Важно: Kaspi не списывает деньги с карты сам — система выставляет счёт, а клиент подтверждает оплату в приложении Kaspi.
В Казахстане регулярные платежи каспи пей встречаются редко. ApiPay даёт эту возможность нативно поверх вашего Kaspi Pay — деньги приходят на ваш обычный Kaspi-счёт, а выставлением регулярных счетов занимается система.
Создаёте подписку с периодом списания — дальше счёт выставляется автоматически, без ручной работы каждый месяц.
Если клиент не оплатил, система сама перевыставляет счёт до 3 раз с интервалом 24 часа.
После исчерпания попыток подписка ещё активна 3 дня. Любая успешная оплата снимает льготный период.
Подписку можно поставить на паузу, возобновить или отменить одним запросом к API.
Одна подписка создаётся запросом POST /subscriptions. Дальше выставление счетов идёт автоматически.
| Параметр | Описание |
|---|---|
phone_number | Номер телефона клиента |
billing_period | Период списания: daily, weekly, monthly, yearly |
billing_day | День списания (опционально) |
amount либо cart_items | Сумма счёта либо корзина товаров |
Система сама выставляет счёт в дату next_billing_at (или сразу, если указать bill_immediately). По каждому выставленному счёту приходят обычные invoice-вебхуки — те же, что и для одиночных счетов.
| Метод | Endpoint | Действие |
|---|---|---|
| POST | /subscriptions | Создать подписку |
| POST | /subscriptions/{id}/pause | Поставить на паузу |
| POST | /subscriptions/{id}/resume | Возобновить |
| POST | /subscriptions/{id}/cancel | Отменить |
Рекуррентные платежи устроены так, чтобы разовая неоплата не обрывала подписку:
max_retry_attempts раз (по умолчанию 3) с интервалом retry_interval_hours (по умолчанию 24 часа).grace_period_days (по умолчанию 3 дня). Любая успешная оплата снимает льготный период и продолжает подписку.Помимо обычных invoice-вебхуков по каждому счёту, ApiPay присылает события жизненного цикла подписки:
subscription.createdподписка созданаsubscription.payment_succeededочередной платёж прошёлsubscription.payment_failedплатёж не прошёлsubscription.grace_period_startedначался льготный периодsubscription.expiredподписка завершиласьsubscription.pausedподписка на паузеsubscription.resumedподписка возобновленаsubscription.cancelledподписка отмененаРегулярные платежи подходят там, где клиент платит по кругу — за одинаковый период:
ApiPay не берёт процент с оборота — оплата по фиксированной подписке, независимо от суммы и числа платежей:
// JavaScript / Node.js — создание подписки
const response = await fetch('https://api.apipay.kz/api/v1/subscriptions', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
phone_number: '87001234567',
amount: 15000,
billing_period: 'monthly',
description: 'Абонемент, ежемесячно'
})
})
const subscription = await response.json()
// Дальше система сама выставляет счёт каждый период
// и присылает вебхуки о платежахАвтосписания с карты, как у классической банковской подписки, в Kaspi нет — Kaspi не списывает деньги с карты сам. Вместо этого ApiPay автоматически выставляет счёт каждый период, а клиент подтверждает оплату привычным приложением Kaspi. Для продавца это работает как подписка: настраиваете один раз, дальше счёт выставляется автоматически.
Регулярные счета и подписки через Kaspi в Казахстане встречаются редко. ApiPay даёт эту возможность нативно: продавец настраивает подписку один раз, а система сама выставляет регулярный счёт в Kaspi Pay каждый период — клиент подтверждает оплату привычным приложением Kaspi.
Если счёт не оплачен, система сама перевыставляет его до 3 раз с интервалом 24 часа (параметры max_retry_attempts и retry_interval_hours). После исчерпания попыток подписка остаётся активной ещё 3 дня — это льготный период (grace_period_days). Любая успешная оплата снимает льготный период и продолжает подписку.
Да. Подписку можно поставить на паузу, возобновить или отменить запросами POST /subscriptions/{id}/pause, /resume и /cancel. Пока подписка на паузе, новые счета не выставляются; после возобновления выставление продолжается.
Регистрация занимает пару минут. Подписки создаются через API или в личном кабинете.
Войти бесплатно