1. Рекуррентные СБП-подписки
Platega.io API
  • Авторизация
  • Модули CMS
  • SDK
  • Платежи
    • Приём карт по H2H
    • Рекуррентные СБП-подписки
      • Пробный доступ и изменение суммы подписки
      • Подписки по H2H
      • Создать подписку
        POST
      • Получить подписку
        GET
      • Список подписок
        GET
      • Отменить подписку
        POST
      • Проверка возможности обновить подписку
        GET
      • Обновление подписки
        POST
    • Создание платежной ссылки без заданного метода
      POST
    • Создание платежной ссылки с заданным методом
      POST
    • Получение QR-кода для H2H-транзакции
      GET
    • Проверка статуса оплаты платежа
      GET
    • Выгрузка транзакций в CSV
      POST
    • Выгрузка транзакций в Excel
      POST
    • Выгрузка транзакций в Json
      POST
  • Балансы
    • Получение балансов
      GET
  • Возвраты
    • Проверка возможности отмены транзакции
      GET
    • Отмена транзакции
      POST
    • Частичная отмена транзакции
      POST
  • Выводы
    • Создаёт вывод на рублёвую карту через Payout API
    • Создаёт вывод на криптокошелек через Payout API
    • Получение сохранённых карт
      GET
    • Получение сохраненных криптокошельков
      GET
  • Callbacks
    • Колбэки — общая информация
    • CONFIRMED
    • CANCELED
    • CHARGEBACKED
    • PARTIALLY_REFUNDED
    • DISPUTED
  • Schemas
    • Schemas
      • PaymentStatus
      • PaymentMethodInt
      • CreateTransactionRequest
      • CreateTransactionResponse
      • TransactionStatusResponse
      • SubscriptionStatus
      • CallbackSubscriptionStatus
      • SubscriptionInterval
    • Статус платежа в колбэке
    • Результат операции возврата
    • Общие поля колбэка
    • Поля колбэка по возврату
    • CallbackPayload
    • Поля колбэка по подписке
  1. Рекуррентные СБП-подписки

Пробный доступ и изменение суммы подписки

Пробная подписка: полный путь#

Отдельного поля «пробный период» в API нет — и не нужно. Пробный доступ делается сменой суммы: подписка создаётся на символическую сумму, первое списание проходит по ней, а когда подписка стала активной, вы ставите полную цену. Все следующие списания идут уже по новой.
Ниже — весь путь по шагам: что вызвать, что увидит плательщик, что придёт вам и где обычно спотыкаются.

Как это выглядит целиком#

ШагЧто происходитСумма
1Вы создаёте подписку1 ₽
2Плательщик подтверждает подписку на нашей формесписывается 1 ₽
3Подписка становится активной, вам приходит callback—
4Вы меняете сумму на полную—
5Следующее и все дальнейшие списания200 ₽

Шаг 1. Создайте подписку на 1 ₽#

Запрос тот же, что в разделе Создать подписку — меняется только сумма: укажите 1 ₽.
Две вещи, которые стоит решить сразу:
Периодичность ставьте ту, которая нужна после пробного периода. Менять её потом можно, но если сразу поставить правильную, шагов будет меньше.
Свой идентификатор заказа пригодится, чтобы связать подписку с клиентом в вашей системе.
В ответе вы получите идентификатор подписки и ссылку на платёжную форму.

Шаг 2. Отправьте плательщика на форму#

Плательщик открывает ссылку, подтверждает подписку в приложении банка и платит 1 ₽. Это списание называется привязочным: им банк подтверждает согласие на регулярные списания.
Совсем без него обойтись нельзя — бесплатной привязки в СБП нет. Поэтому «бесплатный пробный период» делается иначе: берём 1 ₽ за привязку, а первое полноценное списание отодвигаем на конец пробного срока. Как — в шаге 5.

Шаг 3. Дождитесь активации#

Статусы подписки приходят колбэками — список значений и формат описаны в разделе про колбэки. Здесь важно одно: пока подписка не активна, менять её нельзя.
Проверить статус можно и запросом — Получить подписку:

Шаг 4. Убедитесь, что подписку можно менять#

Необязательный, но полезный шаг — Проверка возможности обновить подписку:
Ответ {"supported": true} — можно менять. false — именно эту подписку изменить нельзя: её останется отменить и оформить новую уже на нужную сумму. Такое бывает, и если вы строите пробный период на поток клиентов, эту проверку лучше делать в коде, а не вручную.

Шаг 5. Поставьте полную сумму#

Эндпоинт Обновление подписки. Передавайте только те поля, которые меняете.
Самый простой вариант — сменить только сумму:
Пробный период на 14 дней. Тем же запросом отодвиньте первое полноценное списание и, если нужно, задайте периодичность:
Ответ:
{
  "subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "updated",
  "amount": 200,
  "nextChargeAt": "2026-11-11T12:00:00Z",
  "intervalUnit": 3,
  "intervalCount": 1
}
Получилось так: клиент заплатил 1 ₽ сегодня, две недели пользуется, 11 ноября с него спишется 200 ₽ и дальше по 200 ₽ каждый месяц.

Поля запроса#

ПолеТипЧто делает
amountчислоновая сумма списания в рублях
nextChargeAtдата и времякогда списать в следующий раз
intervalUnitчислопериод: 1 — день, 2 — неделя, 3 — месяц, 4 — год
intervalCountчислосколько таких периодов между списаниями
intervalUnit и intervalCount передаются только вместе — если прислать одно, запрос не пройдёт. Допустимые значения intervalCount зависят от периода: дни 1–31, недели 1–4, месяцы 1–12, годы 1–3.

Что нужно знать до запуска#

Статус. Менять можно активную подписку, а также ту, по которой списание просрочено.
Потолок суммы — 5000 ₽ за один вызов этого эндпоинта. Если ваша цена выше, напишите в поддержку.
Идущее списание. Если по подписке прямо сейчас выполняется списание, изменение не применится — дождитесь его завершения и повторите запрос.
После отмены подписку менять нельзя: если плательщик или вы запросили отмену, остаётся оформить новую.
Новые параметры работают со следующего списания. Уже прошедшие списания не пересчитываются.
Сумма — это то, что зачислится вам. Если по вашим условиям комиссию платит плательщик, с него спишется сумма вместе с комиссией.
Плательщик может отменить подписку сам — по ссылке из письма, которое мы отправляем после каждого списания. Вы узнаете об этом из колбэка.

Если пришла ошибка#

КодЧто это значитЧто делать
400сумма не прошла проверку, передан только один из двух параметров периода, подписка не в том статусе или её расписание менять нельзяпрочитать message в ответе — там причина; если менять нельзя, оформить новую подписку
404подписка не найденапроверить идентификатор
В теле ошибки приходит message с пояснением и traceId. Если причина непонятна, пришлите traceId в поддержку — по нему мы находим запрос.

Короткий чек-лист#

1.
Создали подписку на 1 ₽ с нужной периодичностью.
2.
Отправили плательщика на форму, дождались привязочного списания.
3.
Поймали колбэк об активации или проверили статус запросом.
4.
Проверили update-supported — если false, оформляете новую подписку.
5.
Вызвали update с полной суммой и, если нужен пробный срок, с nextChargeAt.
6.
Сверили ответ: в нём видно, какие сумма, дата и период теперь стоят.
Modified at 2026-10-28 16:58:23
Previous
Приём карт по H2H
Next
Подписки по H2H
Built with