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

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

Совет

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

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

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

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

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

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

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

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

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

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

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

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

совет

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

инфо

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

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

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

важно

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

совет

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