Перейти к основному содержимому

Создание подписки без фискализации чеков

Метод Create Subscription создаёт подписку (рекуррентный платёж) без оформления чеков. Подходит, если фискализация вам не нужна.

Совет

Если нужны чеки, используйте метод с фискализацией чеков.

Подключение подписок​

Перед работой с API платёжных ссылок нужно оставить заявку на подключение интернет-эквайринга внутри интернет-банка. Сделать это может руководитель или распорядитель с правом подписи в разделе «Сервисы» → «Интернет-эквайринг».

В течение рабочего дня с момента заявки с вами могут связаться специалисты для подтверждения заявки.

Проверить статус подключения интернет-эквайринга можно с помощью метода Get Retailers.
Статус REG и значение isActive: «true» будут означать, что настройка завершена — можно приступать к работе с платёжными ссылками.

Создание подписки (рекуррентного платежа)​

Для создания платёжной ссылки нужно вызвать метод Create Subscription и передать:

  • amount — сумма платежа в рублях
  • customerCode — уникальный код клиента
  • purpose — назначение платежа, которое увидит перешедший по ссылке покупатель

Дополнительно можно указать​

  • redirectUrl — URI-адрес, на который нужно перенаправить покупателя после оплаты.
  • failRedirectUrl — URI-адрес, на который нужно перенаправить покупателя, если оплата не прошла.
  • saveCard — параметр, указывающий, будет ли покупателю предложено сохранить карту для следующих платежей.
  • consumerId — идентификатор покупателя. Если ранее был указан параметр saveCard и клиент согласился с сохранением карты, то из ответа можно взять consumerId и подставить в запрос, чтобы покупатель мог выбрать карту, по которой уже происходила оплата.
  • merchantId — идентификатор торговой точки в интернет-эквайринге. Параметр является обязательным, если у вас подключено несколько торговых точек для работы с интернет-эквайрингом.
  • paymentLinkId — уникальный идентификатор заказа. Покупатель увидит его после перехода по платёжной ссылке. Если не передать этот параметр, интернет-эквайринг укажет в этом поле порядковый номер созданной ссылки.
важно

Для каждой платёжной ссылки значение paymentLinkId должно быть уникальным. Создать платёжную ссылку с уже существующим идентификатором не получится — вернётся ошибка.

  • Options — объект, содержащий опции подпски.
  • trancheCount — количество списаний по подписке. По умолчанию установлено 12 списаний. Подробнее об этом параметре вы можете почитать на обзорной странице.
  • period — периодичность списания. По умолчанию устанавливается месяц (Month). Подробнее об этом параметре вы можете почитать на обзорной странице.
  • daysInPeriod — длина периодичности списания в днях. Работает только с периодом в днях (Day).
Совет

Чтобы сразу узнать о поступлении оплаты, вы можете настроить вебхук с событием acquiringInternetPayment на свой URL.