44 KiB
Динамический QR-код
Динамический QR-код
Оплата по динамическому QR-коду — это один из способов безналичной оплаты, альтернатива платежам совершаемых банковскими
Динамический QR-код создается отдельно под каждую конкретную покупку, поэтому он сразу содержит стоимость покупки и все не
Для генерации динамического QR-кода необходимо устройство: компьютер, смартфон или терминал. Чтобы провести оплату касси мобильного телефона или через банковское приложение, подтверждает оплату. Средства мгновенно поступают на счёт продавца.
- Запрос на регистрацию динамического QR-кода
Метод GetQRCd
a) Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…50) y Тип запроса. Константа «GetQRCd».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcType String (n-2) y Тип запрашиваемого QR-кода — «02».
amount Number y Сумма платежа в минорных единицах (копейках).
currency String (ans-3) y Код валюты (для рублей должен передаваться «RUB»).
OrderNumber String (ans-1000) o Номер заказа.
В параметре должны передаваться только английские буквы и/или арабские
width String o Ширина картинки QR-кода (только числовое значение).
height String o Высота картинки QR-кода (только числовое значение).
paymentPurpose String (ans-140) o Назначение платежа.
messageID String (an-1…1024) o Уникальный идентификатор сообщения, GUID. Только латинские символы!
qrTtl String (an-1…6) o Срок жизни Платежной ссылки СБП в минутах.
Минимальное допустимое значение — «1». Максимальное допустимое значен
Рекомендация: устанавливать срок жизни Платежной ссылки СБП не менее «
queryData.notificationUrl String (ans-512) o Полный URL для получения уведомления о финальном статусе оплаты QR-ко
Если параметр отсутствует, уведомление не производится.
redirectUrl String (ans-1024) о Содержит ссылку для автоматического возврата в приложение или на сайт ТСП
Если все же требуется использовать в redirectUrl кириллические символы, необх
Блок для внесения д
Код ключа Тип данных required
extJsonParams Object o
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 1/16
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1
Код ключа Тип данных required
JsonParam1 String (ans-250) o
JsonParam2 String (ans-250) o
... ... ...
JsonParam10 String (ans-250) o
Если требуется сформировать динамический QR-ко
Код ключа Тип данных required Назначение
subscriptionServiceId String (32) o Идентификатор привязки. Обязательно при наличии subscriptionServiceName, т. к. параметры subscriptionS
их в ходе проверки данных привязки счёта на уникальность.
subscriptionServiceName String (70) o Наименование привязки. Обязательно при наличии subscriptionServiceId, т. к. параметры subscriptionServic
их в ходе проверки данных привязки счёта на уникальность.
Если требуется сформировать динамический QR-код под о
Код ключа Тип данных required Назначен
queryData.SenderFIO String (an-140) o Фамилия,
queryData.SenderID String (an-11.13) o Идентифи
queryData.SenderBankBIC String (n-9) o БИК Банка
- Блок для передачи дополнительных идентификаторов ТСП в ежедневные реестры СБП. Функционал потребует дополнительной н
b) Примерный формат запроса:
1 {
2 "command":"GetQRCd",
3 "TermNo":"90080567 ",
4 "qrTtl":"5",
5 "amount":"10000",
6 "currency":"RUB",
7 "qrcType":"02",
8 "width":"600",
9 "height":"600",
10 "paymentPurpose":"Назаначение платежа",
11 "OrderNumber":"FYI123456",
12 "subscriptionServiceId":"3842ca282aea11e88feca860b60304d5",
13 "subscriptionServiceName":"Подписка на онлайн-кинотеатр",
14 "messageID":"f9aa54ff-a615-44b8-aa6c-acab655c89f8",
15 "redirectUrl": "https://alfabank.ru/sme/payservice/sbp/",
16 "extJsonParams":
17 {
18 "JsonParam1":"Value",
19 "JsonParam2":"Value",
20 "JsonParam3":"Value",
21 "JsonParam4":"Value",
22 "JsonParam5":"Value",
23 "JsonParam6":"Value",
24 "JsonParam7":"Value",
25 "JsonParam8":"Value",
26 "JsonParam9":"Value",
27 "JsonParam10":"Value"
28 },
29 "queryData":
30 {
31 "notificationUrl":"https://sbp-payments",
32 "SenderFIO":"Иванов|Иван|Иванович",
33 "SenderID":"0079123456789",
34 "SenderBankBIC":"44525593"
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 2/16
c) Описание параметров ответа:
Код ключа Тип данных required Назначен
ErrorCode String (an-20) y Код ответа
TermNo String (an-20) y Уникальны
image String (an)
Длинна зависит от формата, порядок 7000 символов.
y Изображен
message String (ans-1024) y Расшифро
messageID String (ans-1024) o Уникальны
Значение
payload String (1…999) y Платежная
payrrn String (n-12) y Референс
qrcId String (an-32) y Идентифи
status String (n-7) y Статус рег
*, ** Таблица возможных кодов ответа приведена в приложении 2.
*** Формат payload может быть двух видов:
d) Примерный формат ответа:
• 200 OK
Примечание: текстовые данные передаются в формате urlencoded.
• 400 Bad Request { "ErrorCode":"Код ответа", "message":"Расшифровка кода ответа" }
- Запрос статуса оплаты по динамическому QR-коду
Запрос статуса GetQRCstatus направляется кассой/терминалом ТСП в Банк для получения статуса Операции оплаты выпущенного ра
Запрос статуса направляется не ранее, чем через 10 секунд после формирования QR-кода и не чаще чем каждые 3 секунды.
Успешный ответ на запрос статуса можно получить в течении 30 дней после совершения оплаты по данному QR-коду.
В случае, если срок хранения данных истек, то в ответе на запрос вернется:
35 }
36 }
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "image":"iVBORw0KGgoAAAANSUhEUgAAghjysAAAAgjjafggkqqBEoAAARKCAIAAAQA/w……………..................Y
5 "message": "OK",
6 "messageID": "f9aa54ff-a615-44b8-aa6c-acab655c89f8",
7 "payload": "https://qr.nspk.ru/AD100026KQ0ESJBV8OFPCG0U9K1H52UM",
8 "payrrn": "000000022154",
9 "qrcId": "AD100026KQ0ESJBV8OFPCG0U9K1H52UM",
10 "status": "CREATED"
11 }
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 3/16
https://qr.nspk.ru/AD100026KQ0ESJBV8OFPCG0U9K1H52UM https://qr.nspk.ru/AD100026KQ0ESJBV8OFPCG0U9K1H52UM?type=02&bank=100000000008&sum=10000&cur=RUB&crc=4244
Метод GetQRCstatus
• Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…50) y Тип запроса. Константа «GetQRCstatus».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcId String (an-32) y/o Идентификатор QR-кода (обязательно, есл
payrrn String (n-12) y/o Референсный идентификатор запроса в си
messageID String (ans-1024) o Уникальный идентификатор сообщения, G
• Примерный формат запроса:
• Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ответа*.
message String (ans-1024) y Расшифровка кода ответа**.
qrcId String (an-32) y Идентификатор QR-кода.
status String(an-10) y Статус оплаты QR-кода в НСПК***.
Возможные значения:
-
ACWP — ACCEPTED операция завершена успешно;
-
RJCT — REJECTED операция отклонена;
-
NTST — NOT_STARTED операции по QR коду не существует;
-
RCVD — RECEIVED операция в обработке.
trxId String (an-32) y Уникальный идентификатор платежа в НСПК.
trxDT String (n-14) y Дата и время платежа по Гринвичу.
Формат — ГГГГММДДччммсс.
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка.
CreditDatePos String (ans 1-256) y Дата операции, установленная Банком Получателя (ГГГГММДД)
TermNo String (an-20) y Уникальный идентификатор терминала.
{
"ErrorCode":999,
"message":"Неизвестный код проблемы 999RQ05014"
}
{
"command":"GetQRCstatus",
"TermNo":"90080567",
"qrcId":"AD100026KQ0ESJBV8OFPCG0U9K1H52UM",
"payrrn":"000000022154",
"messageID": "message"
}
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 4/16
Код ключа Тип данных required Назначение
amount Number y Сумма платежа в минорных единицах (копейках).
currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»).
Url String (ans 1-512) o Полный URL для получения уведомления ТСП о финальном статусе оплаты QR-кода. Зн
payerId String (n-13) y Идентификатор плательщика (маскированный номер телефона плательщика).
Kzo String (ans 1-128) o Контрольное Значение Операции СБП.
Формируется на стороне НСПК.
Присутствует при условии, что Операция СБП C2B по запрашиваемому qrcId заверше
messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID.
Значение параметра возвращается в случае, если оно указано в запросе.
merchantId String (12) o ID мерчанта (ТСТ) в Банке
*, ** Таблица возможных кодов ответа приведена в приложении 2.
Примечание:
• Успешно оплаченным считается только QR-код, для которого получен «status» = «ACWP» с идентификатором платежа «trxId» и «E
• В случае если получен «status» = «NTST» — означает необходимость повтора запроса до получения одного из финальных статусов
• Получение «status» = «RJCT» означает отказ в оплате данного QR-кода.
— Примерный формат ответа:
• 200 OK
Примечание:
• Текстовые данные передаются в формате urlencoded.
• В поле " trxDT» содержится дата и время транзакции на ПШ Банка в формате ГГГГММДДччммсс.
В случае получения значения trxId = null необходимо повторить запрос. Отсутствие значения означает, что в СБП еще нет успешного
• 400 Bad Request
1 {
2 "ErrorCode": 0,
3 "message": "OK",
4 "qrcId": "AD100026KQ0ESJBV8OFPCG0U9K1H52UM",
5 "status": "ACWP",
6 "trxId": "A3013090427361010000057B3DA2D4A7",
7 "trxDT": "20230113090427",
8 "payrrn": "000000022154",
9 "CreditDatePos": "20230113",
10 "TermNo": 90080567,
11 "amount": 10000,
12 "currency": "RUB",
13 "Url":"https://sbp-payments",
14 "payerId": "*********1234",
15 "kzo": "212b906a810f2562fd88e145199b30f4b4ea5c7cd7d0261236a73a6152f07f56b7feb915712a055522ee9b76
16 "messageID": "message",
17 "merchantId": "MB0000009603"
18 }
{
"ErrorCode":"Код ответа",
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 5/16
- Нотификация ТСП о финальном статусе оплаты по динамическому QR-коду
Запрос отправляется из ПШ Банка во внутреннюю систему ТСП на URL адрес, указанный в параметре «queryData.notificationUrl» при н
Метод «qrc/notification»
a) Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1...50) y Тип запроса. Константа «qrc/notification»
qrcId String (an-32) y Идентификатор QR-кода.
trxId String (an-32) y Уникальный идентификатор платежа в НСПК.
status String (an-10) y Статус оплаты QR-кода в НСПК.
Возможные значения:
— ACWP — ACCEPTED операция завершена успешно;
— RJCT — REJECTED операция отклонена.
amount Number y Сумма платежа в минорных единицах (копейках)
timestamp YYYY-MMDDThh: mm: ss[.SSS]
или
YYYY-MMDDThh: mm: ss[.SSSZ]
y Метка времени НСПК по Гринвичу (GMT).
payerId String (n-13) y Идентификатор плательщика (маскированный номер те
kzo String (ans 1-128) o Контрольное Значение Операции СБП.
Формируется ОПКЦ СБП. Присутствует при условии, чт
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка
TermNo String (an-20) Y Уникальный идентификатор терминала.
CreditDatePos String (ans 1-256) o Дата операции, установленная Банком Получателя в хо
b) Примерный формат запроса:
c) ВС ТСП отвечает http-кодом «200» — успешное получение нотификации, или ошибкой.
В настоящий момент ответ ВС не обрабатывается шлюзом Агента ТСП. Обработка ответов ТСП находится в разработке.
В случае добавления со стороны НСПК дополнительных параметров уведомления, система, принимающая их от шлюза Альфа-Банка,
"message":"Расшифровка кода ответа"
}
1 {
2 "command":"qrc/notification",
3 "qrcId":"AD100026KQ0ESJBV8OFPCG0U9K1H52UM",
4 "trxId":"A3013090427361010000057B3DA2D4A7",
5 "status":"ACWP",
6 "amount":"10000",
7 "timestamp":"2022-10-27T14:33:49.000Z ",
8 "payerId":"*********1779",
9 "kzo":"580d2f38370f378db5915c047ba7b72014327ce455caa927b2488f224926daac85e82984c889d66e79dad8039cc
10 "payrrn":"000000022154",
11 "TermNo":"90080567",
12 "CreditDatePos":"20221027"
13 }
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 6/16
- Запрос проведения возврата по успешной оплате по динамическому QR-коду
Возврат по СБП состоит из 2х последовательных запросов:
• GetQRCreversalData — проверка возможности проведения возврата;
• QRCreversal — выполнение непосредственно самого возврата.
В случае если ТСП инициирует выполнение повторных операций СБП B2C по одной и той же операции СБП C2B, то допускается не б
Возврат в один этап. При направлении запроса «QRCReversal», с заполненным полем messageID будет произведен возврат в один
4.1. Запрос возможности проведения возврата
Запрос GetQRCreversalData направляется ТСП в Банк для проверки возможности возврата по ранее оплаченному QR-коду и получен
Метод GetQRCreversalData
a) Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…50) y Тип запроса. Константа «GetQRCreversalData».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcId String (an-32) y/o Идентификатор QR-кода (обязательно, если не передан «payrrn» или «trxId»).
payrrn String (n-12) y/o Референсный идентификатор запроса в системе Банка (обязательно, если не
trxId String (an-32) y/o Уникальный идентификатор платежа в НСПК (обязательно, если не передан «q
trxDT String (n-14) o Дата и время отменяемого платежа.
amount Number o Сумма возврата в минорных единицах (копейках). Если сумма возврата не пер
currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»). В случае пустого значе
messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID. Только латинские символы!
ReturnRestAmount Boolean o Проверка доступного остатка для совершения возврата.
Доступные значения:
— true
— false
Примечание:
• Для поиска оригинальной транзакции обязательным является один из параметров: «qrcId», «payrrn» или «trxId»;
• Терминалы с подключенным сканером и распознаванием QR-кодов могут получить «qrcId», распарсив строку QR-кода с чека опла
b) Примерный формат запроса:
c) Описание параметров ответа:
1 {
2 "command":"GetQRCreversalData",
3 "TermNo":"90080567",
4 "qrcId":"AS1000670LSS7DN18SJQDNP4B05KLJL2",
5 "payrrn":"000063441405",
6 "trxId":"X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
7 "trxDT":"20230313052005",
8 "amount":"10000",
9 "currency":"RUB",
10 "messageID":"f9aa54ff-a615-44b8-aa6c-acab655c89f8",
11 "ReturnRestAmount":true
12 }
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 7/16
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ответа*.
TermNo String (an-20) y Уникальный идентификатор терминала.
message String (ans-1024) y Расшифровка кода ответа**.
messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID. Только латинские символы!
payerBnkBIC String (n-9) y БИК банка получателя.
payerBnkName String (an-50) y Наименование банка получателя
payerId String (n-13) y Идентификатор получателя (маскированный номер телефона получателя).
payerPam String (ans 1…140) y PAM получателя
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка
qrcId String (an-32) y Идентификатор QR-кода
trxDT String (n-14) y Дата и время платежа по Гринвичу (GMT).
Формат времени — ГГГГММДДччммсс.
trxId String (an-32) y Уникальный идентификатор платежа в НСПК.
restAmount Number (с двумя знаками после точки) o Сумма доступного остатка к возврату.
Если в запросе передано значение "ReturnRestAmount" : true, то в ответе д
*, ** Таблица возможных кодов ответа приведена в приложении 2.
d) Примерный формат ответа:
• 200 OK
Примечание:
• Текстовые данные передаются в формате urlencoded;
• В случае получения «message»: «Получен отказ на запрос возврата. Статус Recall, ErrDebetMerchant: KSM0284 Invalid special cond
• 400 Bad Request
4.2. Запрос возврата оплаты QR-кода
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "message": "OK",
5 "payerBnkBIC": "044525593",
6 "payerBnkName": "Альфа-Банк",
7 "payerId": "*1234",
8 "payerPam": "ФСИ",
9 "payrrn": "000063441405",
10 "qrcId": "AS1000670LSS7DN18SJQDNP4B05KLJL2",
11 "trxDT": 20200728114531,
12 "trxId": "X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
13 "restAmount":"99.87"
14 }
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 8/16
Запрос QRCreversal направляется ТСП в Банк для возврата по ранее произведенной оплате QR. Возврат производится только на сче
Метод QRCreversal
a) Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…50) y Тип запроса. Константа «QRCreversal».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcId String (an-32) y/o Идентификатор QR-кода (обязательно, если не передан «payrrn» или «trx
payrrn String (n-12) y/o Референсный идентификатор запроса в системе Банка (обязательно, есл
trxId String (an-32) y/o Уникальный идентификатор платежа в НСПК (обязательно, если не перед
trxDT String (n-14) o Дата и время отменяемого платежа.
amount Number o Сумма возврата в минорных единицах (копейках). Если сумма возврата н
currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»). В случае пустого
messageID String (an-1…50) y/o Уникальный идентификатор сообщения, GUID из сообщения «GetQRCrev
queryData.notificationUrl String (ans-512) o Полный URL для получения уведомления о финальном статусе возврата
ReturnRestAmount Boolean o Проверка доступного остатка для совершения возврата.
Доступные значения:
— true
— false
Блок для внесения д
Код ключа Тип данных required
extJsonParams Object o
JsonParam1 String (ans-250) o
JsonParam2 String (ans-250) o
... ... ...
JsonParam10 String (ans-250) o
- messageID — необходимо передавать точное значение, которые было указано в ответе на запрос GetQRCreversalData. Если значени на возврат.
** Блок для передачи дополнительных идентификаторов ТСП в ежедневные реестры СБП. Функционал потребует дополнительной
Примечание: Для поиска оригинальной транзакции обязательным является один из параметров: «qrcId», «payrrn» или «trxId».
b) Примерный формат запроса:
1 {
2 "command":"QRCreversal",
3 "TermNo":"90080567",
4 "qrcId":"AS1000670LSS7DN18SJQDNP4B05KLJL2",
5 "payrrn":"000063441405",
6 "trxId":"X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
7 "trxDT":"20230313052005",
8 "amount":"10000",
9 "currency":"RUB",
10 "messageID":"f9aa54ff-a615-44b8-aa6c-acab655c89f8",
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 9/16
c) Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ответа*.
TermNo String (an-20) y Уникальный идентификатор терминала.
amount Number y Сумма платежа в минорных единицах (копейках).
currency String (ans-3) y Код валюты (для рублей должен передаваться «RUB»).
message String (ans-1024) y Расшифровка кода ответа**.
messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID. Только латинские символы!
trxDT String(n-14) y Дата и время операции возврата (ГГГГММДДччммсс).
trxId String(an-32) y Уникальный идентификатор операции возврата в НСПК.
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка.
restAmount Number (с двумя знаками после точки) o Сумма доступного остатка к возврату.
Если в запросе передано значение "ReturnRestAmount" : true, то в ответе дол
*, ** Таблица возможных кодов ответа приведена в приложении 2.
d) Примерный формат ответа:
• 200 OK
Примечание: текстовые данные передаются в формате urlencoded.
• 400 Bad Request
11 "extJsonParams":
12 {
13 "JsonParam1":"Value",
14 "JsonParam2":"Value",
15 "JsonParam3":"Value",
16 "JsonParam4":"Value",
17 "JsonParam5":"Value",
18 "JsonParam6":"Value",
19 "JsonParam7":"Value",
20 "JsonParam8":"Value",
21 "JsonParam9":"Value",
22 "JsonParam10":"Value"
23 },
24 "queryData":
25 {
26 "notificationUrl":"http://sbp-refunds/"
27 },
28 "ReturnRestAmount": true
29 }
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "amount": 10000,
5 "currency": "RUB",
6 "message": "%u0412%u043E%u0437%u0432%u0440%u0430%u0442%20%u043F%u0440%u043E%u0432%u0435%u0434%
7 "messageID":"message"
8 "payrrn": "000063441405",
9 "trxDT": 20230624143642,
10 "trxId": "A3024113609260070000086B8426B817",
11 "restAmount": "99.87"
12 }
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 10/16
- Запрос статуса возврата СБП (B2C)
Метод «GetQRCreversalStatus» необходим ТСП для уточнения статуса операции B2C (метод QRCreversal).
В запросе «GetQRCreversalStatus» обязательно должна быть передана пара параметров:
-
«payrrn» или «originalTrxId» Один из параметров «payrrn» или «originalTrxId» используется для нахождения исходного платежа C2
-
«trxId» или «messageID». Один из параметров «trxId» или «messageID» используется для нахождения операции возврата B2C, по
Метод «GetQRCreversalStatus»
a) Описание параметров запроса:
Код ключа Тип данных required
command String (an-1…50) y
TermNo String (an-20) y
payrrn String (n-12) y/o
(обязательно, если не передан параметр «originalTrxId»)
originalTrxId String (an-32) y/o
(обязательно, если не передан параметр «payrrn»)
trxId String (an-32) y/o
(обязательно, если не передан messageID,)
messageID String (ans-1…1024) y/o (обязательно, если не передан trxId)
b) Примерный формат запроса:
c) Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ошибки*.
TermNo String (an-20) y Уникальный идентификатор терминала.
Url String (ans 1-512) o Полный URL получения уведомления для ТСП — значение параметра,
amount Number y Сумма Операции СБП в копейках. Целое, положительное число. Валют
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
{
"command":"GetQRCreversalStatus",
"TermNo":"90080567",
"payrrn":"000063441405",
"originalTrxId":"X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
"trxId":"A3024113609260070000086B8426B817",
"messageID":"message"
}
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 11/16
Код ключа Тип данных required Назначение
message String (ans-1024) y Описание результата выполнения запроса**.
messageID String (ans-1024) o Значение параметра «messageID» из запроса «QRCreversal».
originalQrcId String (an-32) y Идентификатор зарегистрированной Платежной ссылки СБП, по которо
originalTrxId String (an-32) y Идентификатор исходной Операции СБП C2B.
payerId String (an-13) y Маскированный номер телефона Клиента-Получателя (Плательщика в
status String (an-4) y Статус операции возврата СБП (B2C):
ACWP — ACCEPTED операция завершена успешно;
RJCT — REJECTED операция отклонена;
NTST — Статус операции неизвестен.
trxDT String (n-14) y Дата и время выполнения Операции СБП B2C по сценарию «Возврат п
trxId String (an-32) y Уникальный идентификатор операции возврата в НСПК.
*, ** Таблица возможных кодов ответа приведена в приложении 2.
d) Примерный формат ответа:
• 200 ОК
Примечание: текстовые данные передаются в формате urlencoded.
• 400 Bad Request
- Запрос истории возвратов по определённой транзакции СБП C2B
Запрос позволяет ТСП проверить все совершённые возвраты по определённой транзакции СБП C2B.
В ответе на запрос возвращаются как успешные, так и неуспешные попытки возвратов.
Метод GetQRCreversalHistory
a) Описание параметров запроса:
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "amount": 10000,
5 "message": "OK",
6 "messageID": "message"
7 "originalQrcId": "AS1000670LSS7DN18SJQDNP4B05KLJL2",
8 "originalTrxId": "X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
9 "payerId": "*********1234",
10 "status": "ACWP",
11 "trxDT": 20230624143642,
12 "trxId": "A3024113609260070000086B8426B817"
13 }
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 12/16
Код ключа Тип данных required
command String (an-1…50) y
TermNo String (an-20) y
payrrn String (n-12) y
b) Примерный формат запроса:
c) Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ответа*
message String (ans-1024) y Расшифровка кода ответа**
Refunds Array y Массив объектов, содержащих информацию о возвратах по плат
При отсутствии возвратов, будет возвращён ответ с сообщением
refunds.TermNo String (an-20) y Уникальный идентификатор терминала
refunds.amount Number y Сумма Операции СБП B2C (возврат) в копейках. Целое, положител
refunds.originalQrcId String (an-32) y Идентификатор зарегистрированной Платёжной ссылки СБП (QR-к
refunds.originalTrxId String (an-32) y Идентификатор исходной Операции СБП C2B в НСПК
refunds.payerId String (an-15) y Маскированный номер телефона Клиента-Получателя (Плательщи
refunds.status String (an-4) y Статус операции возврата СБП (B2C):
-
ACWP — ACCEPTED возврат успешно выполнен
-
RJCT — REJECTED возврат отклонён
-
NTST — NOT_STARTED возврат не инициирован (получен успе
refunds.trxId String (an-32) y Идентификатор Операции возврата СБП B2C по сценарию «Возвра
refunds.trxDT String (n-4) y Дата и время выполнения Операции возврата СБП B2C по сцена
Формат: ГГГГММДДччммсс, UTC +0
*, ** Таблица возможных кодов ответа приведена в приложении 2.
d) Примерный формат ответа «ACWP» и «RJCT»:
• 200 ОК
{
"command":"GetQRCreversalHistory",
"TermNo":"90080567",
"payrrn":"000000002212"
}
1 {
2 "ErrorCode": 0,
3 "message": "OK",
4 "refunds": [
5 {
6 "TermNo": 90080567,
7 "amount": 10000,
8 "originalQrcId": "AS1F004F30VC6B4A9GRBENS0HI6LGRJM",
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 13/16
• 400 Bad Request
e) Примерный формат ответа «NTST»:
• 200 ОК
• 400 Bad Request
f) Примерный формат ответа при отсутствии возвратов по транзакции СБП C2B:
• 200 OK
Декодирование значения поля «message» - «По данной оплате возвраты не найдены».
• 400 Bad Request
9 "originalTrxId": "B51390819586020Z0000120011510503",
10 "payerId": "*********1234",
11 "status": "ACWP",
12 "trxDT": 20250519082345,
13 "trxId": "B51390823097450W0000180011510503"
14 },
15 {
16 "TermNo": 90080567,
17 "amount": 10000,
18 "originalQrcId": "AS1F004F30VC6B4A9GRBENS0HI6LGRJM",
19 "originalTrxId": "B51390819586020Z0000120011510503",
20 "payerId": "*********1234",
21 "status": "RJCT",
22 "trxDT": 20250519083836,
23 "trxId": "A4327120041167130000020011381101"
24 }
25 ]
26 }
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
1 {
2 "ErrorCode": 0,
3 "message": "OK",
4 "refunds": [
5 {
6 "TermNo": 90080567,
7 "amount": 10000,
8 "originalQrcId": "AS1F004F30VC6B4A9GRBENS0HI6LGRJM",
9 "originalTrxId": "B51390819586020Z0000120011510503",
10 "payerId": "*********1234",
11 "status": "NTST",
12 "trxId": "B51390835362750D0000100011510503"
13 }
14 ]
15 }
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
{
"ErrorCode": 0,
"message": "%u041F%u043E%20%u0434%u0430%u043D%u043D%u043E%u0439%20%u043E%u043F%u043B%u0430%u0442
}
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 14/16
- Нотификация о финальном статусе возврата по динамическому QR-коду
Запрос отправляется из ПШ Банка во внутреннюю систему ТСП на URL адрес, указанный в параметре «queryData.notificationUrl» при н
Метод «b2c-refund/notification»
a) Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…50) y Тип запроса. Константа «b2c-refund/notification»
messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID
TermNo String (an-20) y Уникальный идентификатор терминала
originalQrcId String (an-32) y Идентификатор зарегистрированной Платежно
originalTrxId String (an-32) y Идентификатор исходной Операции СБП C2B
trxId String (an-32) y Идентификатор Операции СБП B2C по сценар
trxDT String (n-14) y Дата и время выполнения Операции СБП B2C
status String (an-4) y Финальный статус Операции СБП B2C:
«ACWP» — ACCEPTED операция завершена у
«RJCT» — REJECTED операция отклонена;
amount Number y Сумма операции в копейках
ErrorCode String (an-20) y Код ответа*
message String (ans-1024) y Расшифровка кода ответа**
payerId String (an-15) y Маскированный номер телефона Клиента-Полу
agentRefundRequestId String (an-32) y Уникальный идентификатор запроса, назначае
opkcRefundRequestId String (an-32) y Уникальный идентификатор запроса на возвра
*, ** Таблица возможных кодов ответа приведена в приложении 2.
b) Примерный формат запроса (по успешному возврату):
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
1 {
2 "command":"b2c-refund/notification",
3 "messageID":" message",
4 "TermNo":"90080567",
5 "originalQrcId":"AS1000670LSS7DN18SJQDNP4B05KLJL2",
6 "originalTrxId":"X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
7 "trxId":" A3024113609260070000086B8426B817",
8 "trxDT":"20230624143642",
9 "status":"ACWP",
10 "amount":"10000",
11 "ErrorCode":"0",
12 "message":"OK",
13 "payerId":"*********1234",
14 "agentRefundRequestId":"00000000000000000182_abcd1994383",
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 15/16
В ответ ожидается:
• http-код «200» — Успешный ответ (Уведомление получено);
• http-код «500» — Внутренняя ошибка.
c) Примерный формат запроса (по отклоненному возврату):
В ответ ожидается:
• http-код «200» — Успешный ответ (Уведомление получено);
• http-код «500» — Внутренняя ошибка.
d) ВС ТСП отвечает http-кодом «200» — успешное получение нотификации, или ошибкой.
В настоящий момент ответ ВС не обрабатывается шлюзом Агента ТСП. Обработка ответов ТСП находится в разработке.
В случае добавления со стороны НСПК дополнительных параметров уведомления, система, принимающая их от шлюза Альфа-Банка,
15 "opkcRefundRequestId":"BR10000OKEISOIPM8ST8TBLQHIN9R185"
16 }
1 {
2 "command":"b2c-refund/notification",
3 "TermNo":"90080567",
4 "originalQrcId":"AS1000670LSS7DN18SJQDNP4B05KLJL2",
5 "originalTrxId":"X1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K2",
6 "trxId":"A3024113609260070000086B8426B817",
7 "trxDT":"20230624143642",
8 "status":"RJCT",
9 "amount":"10000",
10 "ErrorCode":"0",
11 "message":"OK",
12 "payerId":"*********1234"
13 }
12/23/25, 11:23 AM Динамический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1 16/16