docs
КабинетПолучить ключи
Рекуррентные платежи

Как работают подписки

Один раз получите согласие клиента, после чего Cashera будет принимать регулярные платежи по заданному расписанию

Схема интеграции

  1. Создайте подписку методом POST /integration/subscriptions
  2. Перенаправьте клиента на полученный payment_url. Подписка не активируется без подтверждения клиента на стороне платёжного провайдера
  3. Дождитесь вебхука subscription.status_updated со статусом active
  4. Каждое автоматическое списание создаёт обычную транзакцию. Результат приходит событиемtransaction.status_updated и доступен в истории списаний
  5. Когда подписка больше не нужна, вызовите метод отмены
Отдельный метод оплаты

Для подписок используется sbp_recurring. Он должен быть подключён к мерчанту Cashera. Передавать этот код в обычный POST /integration/transactions нельзя - подписка создаётся только через POST /integration/subscriptions.

Интервалы списаний

  • daily - ежедневно
  • weekly - еженедельно
  • monthly - ежемесячно
  • yearly - ежегодно

Интервал задаётся при создании и не изменяется. Числовые значения 1-4 не поддерживаются.

Суммы и зачисление

Все суммы API передаются целыми числами в копейках. Каждое успешное списание проходит как обычный RUB-платёж: применяются сохранённые при создании подписки комиссия и холд, после чего средства зачисляются через стандартный ledger Cashera. Неуспешное списание баланс не увеличивает.

Не отгружайте по статусу подписки

Статус active означает только то, что подписка действует. Товар или услугу за конкретный период выдавайте исключительно после transaction.status_updated со статусомpaid, предварительно сверив сумму, валюту и идентификатор подписки.