Регистрация (получение) кассовой ссылки

/REGISTER

POST

http://qrpay.tbank.ru/qrpay/external/api/v1/operations/REGISTER

Метод используется для получения кассовой ссылки или привязки существующей кассовой ссылки к кассовому ПО

Описание работы метода

• Связывание кассовой ссылки с Кассовым ПО (осуществляется один раз после получения распечатанной обезличенной кассовой ссылки, при повторном вызове связывание не осуществляется).

  • На POS-терминале инициируется операция связывания кассовой ссылки:
    • Кассовое ПО формирует сообщение POST/operations/register c запросом на связывание кассовой ссылки и отправляет его на хост.
    • Хост проводит обработку запроса и выполняет необходимые проверки. Если проверки выполняются, хост осуществляет связывание кассовой ссылки с кассовым ПО.
    • Хост формирует и передает ответ кассовому ПО.
    • Кассовое ПО получает ответ на запрос.

• Регистрация кассовой ссылки (осуществляется один раз для создания и получения кассовой ссылки, при повторном вызове создание кассовой ссылки не осуществляется).

  • На кассовом ПО инициируется операция регистрации кассовой ссылки:
    • Кассовое ПО формирует сообщение POST/operations/register c запросом на регистрацию кассовой ссылки и отправляет его на хост.
    • Хост проводит обработку запроса и выполняет необходимые проверки. Если к кассовому ПО не привязано кассовых ссылок, хост создает новую кассовую ссылку.
    • Хост формирует и передает ответ кассовому ПО.
    • Кассовое ПО получает ответ на запрос.

Запрос

Request body schema application/json

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта

Required

outTransactionNo

Number

Порядковый номер операции на кассовом ПО

Required

signType

String

Requirements: <= 30 characters, [SOFTPOS_SHA256_HMAC, MD5, HMAC_SHA256]

Тип подписи

Required

signature

String

Подпись запроса

Required

terId

String

TID терминала

Required

timeStart

String

Время формирования запроса, pattern = "yyyy-MM-dd'T'HH:mm"

Required

tradeType

String

Requirements: <= 50 characters, [pay.paxpay.cashlink]

Тип операции

Required

version

String

Requirements: <= 4 characters, [V1.0]

Версия интерфейса

qrcId

String

Идентификатор кассовой ссылки. Используется для привязывания обезличенной кассовой ссылки к кассовому ПО.

Ответ

200

Успешный запрос

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции

Loading...