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

Платёжные ссылки с фискализацией

Метод Create Payment Operation With Receipt создаёт платёжную ссылку с фискализацией чеков. Чеки оформляют партнёры Точки по 54-ФЗ.

Совет

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

Подключение платёжных ссылок​

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

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

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

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

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

Генерация платёжной ссылки​

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

  • amount — сумма платежа в рублях.

  • customerCode — уникальный код клиента.

  • purpose — назначение платежа, которое увидит перешедший по платёжной ссылке покупатель.

  • paymentMode — способ оплаты. Можно указать несколько вариантов или все возможные — после перехода по платёжной ссылке покупатель сам выберет способ оплаты. Возможные значения:

    • card — оплата картой
    • tinkoff — оплата через T-pay
    • sbp — оплата по QR-коду
    • dolyame — оплата через сервис «Долями»
совет

Чтобы узнать доступные способы приёма платежей, используйте метод Get Retailers — они будут в массиве paymentModes в данных ритейлера.

инфо

Если оплат через T-pay и Долями нет в списке доступных, оставьте заявку на их подключение в интернет-банке. Обычно подключение занимает 2–3 рабочих дня.

Также для чека передаётся следующее:

taxSystemCode — система налогообложения вашей организации.

Client — данные покупателя​

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

Items — список товаров в заказе​

  • name — название товара или услуги. Этот параметр передавать обязательно.
  • amount — цена за единицу. Этот параметр передавать обязательно.
  • quantity — количество. Этот параметр передавать обязательно.
  • vatType — ставка НДС по позиции.
  • paymentMethod — тип оплаты: full_payment (полная оплата) или full_prepayment (полная предоплата).
  • paymentObject — признак предмета расчёта: goods (товары), service (услуги), work (работа).
  • measure — единица измерения (по умолчанию — штуки).

Supplier — данные поставщика​

Нужны, если вы работаете как агент и продаёте не свой товар — по 54-ФЗ эти данные должны быть в чеке.

  • phone — телефон поставщика.
  • name — название компании или ФИО (для ИП).
  • taxCode — ИНН поставщика.
инфо

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

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

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

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

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

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

  • redirectUrl — URI-адрес, на который нужно перенаправить покупателя после оплаты.
  • failRedirectUrl — URI-адрес, на который нужно перенаправить покупателя если оплата не прошла.
  • saveCard — параметр, указывающий, будет ли покупателю предложено сохранить карту для следующих платежей.
  • consumerId — идентификатор покупателя. Если ранее был указан параметр saveCard и клиент согласился с сохранением карты, то из ответа можно взять consumerId и подставить в запрос, чтобы покупатель мог выбрать карту, по которой уже происходила оплата.
  • taxSystemCode — система налогообложения, которая используется в организации.
  • merchantId — идентификатор торговой точки в интернет-эквайринге. Параметр является обязательным, если у вас подключено несколько торговых точек для работы с интернет-эквайрингом.
  • ttl — время действия платёжной ссылки в минутах, можно указать от 1 до 44 640 минут. Если при создании ссылки не передать этот параметр, срок действия составит 10 080 минут.
  • preAuthorization — поле показывает, будет ли использоваться двухэтапная оплата. Неактуально для оплат через Систему быстрых платежей (СБП). Значение по умолчанию — false.
  • paymentLinkId — уникальный идентификатор заказа. Покупатель увидит его после перехода по платёжной ссылке. Если не передать этот параметр, интернет-эквайринг укажет в этом поле порядковый номер созданной ссылки.
важно

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

совет

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