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

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

Метод Create Subscription With Receipt создаёт подписку (рекуррентный платёж) с фискализацией чеков. Чеки оформляются партнёрами Точка Банка.

Метод работает так же, как создание подписок без фискализации, но дополнительно принимает данные для чека.

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

Перед работой с API платёжных ссылок нужно отправить заявку на подключение интернет-эквайринга и выбрать партнёра, который будет фискализировать ваши чеки по 54-ФЗ.

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

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

Проверить статус подключения интернет-эквайринга можно с помощью метода Get Retailers.

Статус REG и значение isActive: "true" будут означать, что настройка завершена — можно приступать к работе с платёжными ссылками.

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

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

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

Client — объект, содержащий данные покупателя

  • email — электронная почта покупателя, на которую будет отправлен чек

Items — объект, содержащий список товаров в заказе

  • name — название товара или услуги
  • amount — цена за единицу товара или услуги
  • quantity — количество товаров или оказанных услуг

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

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

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

Options — объект, содержащий опции подпски.

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

Client — объект, содержащий данные покупателя.

  • name — наименование плательщика. Для юрлица — название организации, для ИП и физического лица — ФИО.
  • phone — телефон покупателя для отправки чека.

Items — объект, содержащий список товаров в заказе.

  • vatType — ставка НДС в позициях.
  • paymentMethod — тип оплаты. full_payment — полная оплата, full_prepayment — полная предоплата.
  • paymentObject — признак предмета расчёта. goods — товары, service — услуги, work — работа.
  • measure - единица измерения. По умолчанию ставится штуки.

Supplier — объект с информацией о поставщике товара. Если вы работаете как агент и продаёте не свой товар, эти данные должны быть в чеке согласно 54-ФЗ.

  • phone — номер телефона поставщика.
  • name — название его компании или ФИО, если поставщик — ИП.
  • taxCode — ИНН поставщика.
инфо

Данные о поставщике можно указать как отдельным объектом supplier, так и внутри объекта items. Если использовать оба способа одновременно, данные в items.supplier будут приоритетнее.

Например, у вас 10 разных товаров, и вы передаёте такие данные:

  • Для 3 товаров — данные их поставщиков в items.supplier
  • Для остальных 7 товаров вы не заполняете items.supplier
  • В отдельном объекте supplier вы указываете другого поставщика

После оплаты в фискальном чеке будет указано:

  • Для 3 товаров — поставщики из items.supplier
  • Для остальных 7 — поставщик из отдельного объекта supplier
Совет

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