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

/REGISTER

POST

https://qrpay.tinkoff.ru/qrpay/external/api/v1/operations/REGISTER

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

Схема работы метода

Связывание кассовой ссылки с кассовым ПО

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

На POS-терминале инициируется операция связывания кассовой ссылки:

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

Регистрация кассовой ссылки

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

На кассовом ПО инициируется операция регистрации кассовой ссылки:

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

Запрос

Request body schema application/json

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта.

Required

outTransactionNo

Number

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

Required

signType

String

Requirements: <= 30 characters, [HMAC_SHA256]

Тип подписи.

Required

signature

String

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

Required

terId

String

TID терминала.

Required

timeStart

String

Время формирования запроса. Формат — yyyy-MM-dd'T'HH:mm:ss.

Required

tradeType

String

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

Тип операции.

Required

version

String

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

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

qrcId

String

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

Ответ

200

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

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

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

Loading...