Общая информация о подписках (рекуррентных платежах)

Для работы с подписками вам потребуются разрешения MakeAcquiringOperation, ReadAcquiringData и ReadCustomerData.

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

Создать подписку можно двумя способами:

• Без фискализации чеков — метод Create Subscription.
• С фискализацией чеков — метод Create Subscription With Receipt, чеки оформляют партнёры Точки.

Общие для обоих способов параметры, график списания и особенности описаны ниже.

Что нужно для работы

• customerCode — ваш уникальный код в системе банка. Нужен для большинства методов. Получить его можно методом Get Customers List, брать значение из поля с customerType: "Business".
• merchantId — идентификатор торговой точки - 15 цифр. Если у вас подключено несколько торговых точек для интернет-эквайринга, передавать merchantId обязательно. Получить — методом Get Retailers.

График списания

График задаётся двумя параметрами:

• period — периодичность списания. Возможные значения (чувствительны к регистру): Day, Month, Year.
• trancheCount — общее количество списаний по графику.

Ограничение на количество списаний

Максимальное значение trancheCount зависит от периодичности:

period	Периодичность	Максимум trancheCount
Day	1 раз в N дней	100
Month	1 раз в месяц	84
Year	1 раз в год	10

Инфо

Ограничение действует для обоих методов создания подписки с графиком. Если передать trancheCount больше допустимого, то создать подписку не получится.

Срок действия ссылки

Ссылка для подключения подписки действует 168 часов - 7 дней. После перехода по ссылке у покупателя есть 1 час на оплату. Если время вышло, покупатель увидит ошибку, но при повторном переходе сформируется новая рабочая страница оплаты.

Дополнительные методы для работы с подписками (рекуррентными платежами)

Метод Get Subscription List позволяет получать все созданные подписки. В ответе будут показаны как активные, так и неактивные подписки. Для удобства можно использовать параметры page — номер страницы и perPage — количество записей на странице.

Метод Get Subscription Status покажет актуальный статус подписки. Для вызова этого метода необходимо передать operationId — идентификатор подписки.

Метод Set Subscription Status позволяет отключить подписку, переведя её в статус Cancelled.

Несколько особенностей в работе с подписками (рекуррентными платежами)

• Возврат платежа за подписку можно провести только в интернет-банке.
• Продлить подписку пока нельзя. Если она закончится, нужно создать новую.
• Сейчас можно создать подписку только для приёма платежей с банковских карт. Оплата другими способами пока недоступна.
• Нельзя создать подписку с параметром recurring и объектом Options одновременно.