Документация/Другие операции/Подписки
Подписки
Рекуррентные списания по расписанию на основании мандата — согласия плательщика, полученного при первой оплате.
Доступность
Публичный онбординг подписок пока не включён
Эндпоинты описаны и присутствуют в контракте, но пригодный к использованию mandate_id наружу пока не выдаётся. До включения раздела согласуйте подключение с CalibriPay — иначе создание подписки не пройдёт валидацию мандата.
Мандат
Мандат появляется, когда первый платёж создан с условиями подписки. В этих условиях фиксируются интервал, дата первого списания и версия раскрытия условий, которую видел плательщик:
{
"subscription": {
"interval_unit": "month",
"interval_count": 1,
"first_charge_at": "2026-09-01T06:00:00Z",
"disclosure_version": "2026-08"
}
}Согласие плательщика страница оплаты собирает отдельно и заново — согласие на разовый платёж не является согласием на регулярные списания.
Создание
Запрос
POST /api/v1/subscriptions
Idempotency-Key: subscription-cust-7f21d0-1
{
"mandate_id": "0198a1c2-55f0-7b16-9d42-e8073ab6c154",
"amount_minor": 990,
"currency": "EUR",
"interval_unit": "month",
"interval_count": 1,
"first_run_at": "2026-09-01T06:00:00Z"
}Интервал задаётся парой полей: interval_unit (day, week, month, year) и interval_count. Раз в две недели — это week с количеством 2, а не отдельная единица измерения.
Пауза, возобновление, отмена
POST /api/v1/subscriptions/{subscription_id}/pause
POST /api/v1/subscriptions/{subscription_id}/resume
POST /api/v1/subscriptions/{subscription_id}/cancelПауза останавливает списания, сохраняя мандат; возобновление возвращает подписку в расписание. Отмена необратима — для возобновления отношений понадобится новый мандат, то есть новое согласие плательщика.
События
Подписки сообщают о себе вебхуками с корнем data.subscription: subscription.created, subscription.updated, subscription.payment_succeeded, subscription.payment_failed и subscription.past_due.
subscription.past_due платформа формирует, но в списке подписки кабинета его пока нет — до синхронизации интерфейса просроченные подписки отслеживаются сверкой по статусу.