25 KiB
Статический QR-код
Статический QR-код
Оплата по статическому QR-коду — это один из способов безналичной оплаты, альтернатива платежам совершаемых банковскими к
Статический QR-код представляет из себя изображение, которое можно распечатать и разместить на видном месте возле кассовой
Изображение такого QR-кода всегда остается неизменным.
Данный вид QR-кода реализован в двух вариантах:
• с открытой суммой, которую вводит сам покупатель;
• с фиксированной суммой, заполняемой продавцом.
Совершить оплату по статическому QR-коду возможно следующими способами:
• отсканировать изображение QR-кода камерой смартфона и далее перейти в приложение мобильного банка или отсканировать не приложения банка;
• в случае если изображение QR-кода содержит NFC-метку, то приложить смартфона с включенным NFC-модулем и совершить опл
Если QR-код уже с фиксированной суммой, то произвести оплату по цене, указанной в реквизитах платежа, если сумма открытая, то
Средства мгновенно поступают на счёт продавца.
Терминал или дополнительное устройство в данном случае не требуется.
- Запрос на регистрацию статического QR-кода
Метод GetQRCd
• Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…
y Тип запроса. Константа «GetQRCd».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcType String (n-2) y Тип запрашиваемого QR-кода — «01».
amount Number o Сумма платежа в минорных единицах (копейках).
Значение не указывается, если сумма по платежу вводится плательщиком (сумма открыта).
width String o Ширина картинки QR-кода (только числовое значение).
height String o Высота картинки QR-кода (только числовое значение).
currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»).
paymentPurpose String (ans- 140)
o Назначение платежа.
redirectUrl String (ans-
о Содержит ссылку для автоматического возврата в приложение или на сайт ТСП. Допускаются только си
соответствовать правилам кодировки URL.
Если все же требуется использовать в redirectUrl кириллические символы, необходимо перекодировать
encoded octets согласно RFC3986.
messageID String (ans-
o Уникальный идентификатор сообщения, GUID. Только латинские символы!
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 1/9
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1
Код ключа Тип данных required Назначение
queryData.notificationUrl String (ans-
o Полный URL для получения уведомления о финальном статусе оплаты QR-кода. Если параметр отсутс
• Примерный формат запроса:
• Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ответа*.
TermNo String (an-20) y Уникальный идентификатор терминала.
image String (an)
Длинна зависит от формата, порядок 7000 символов.
y Изображение QR-кода содержит энкодированный BASE64 файл из
message String (ans-1024) y Расшифровка кода ответа**.
payload String (1…999) y Платежная ссылка***.
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка.
qrcId String (an-32) y Идентификатор QR-кода.
messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID.
status String (an-20) y Статус регистрации Платежной ссылки СБП.
*, ** Таблица возможных кодов ответа приведена в приложении 2.
*** Формат payload может быть двух видов:
• Примерный формат ответа:
• 200 ОК
1 {
2 "command":"GetQRCd",
3 "TermNo":"90080567",
4 "qrcType":"01",
5 "width":"600",
6 "height":"600",
7 "amount":"10000",
8 "currency":"RUB",
9 "paymentPurpose":"Назначение платежа",
10 "messageID":"message",
11 "queryData":
12 {
13 "notificationUrl":"https://sbp-payments"
14 },
15 "redirectUrl": " https://exampletsp.io/qwertyui "
16 }
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "image": "iVBORw0KGgoAAAANSUhEUgAABEoAAARKCAIKFIRoUEQWVNAAAQA/w…...YII",
5 "message": "OK",
6 "messageID": "message",
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 2/9
https://qr.nspk.ru/AS10000NJTDV88TN82CRT8CG1AU690OF https://qr.nspk.ru/AS10000NJTDV88TN82CRT8CG1AU690OF?type=01&bank=100000000008&sum=100&cur=RUB&crc=2D0D
Примечание: текстовые данные передаются в формате urlencoded.
• 400 Bad Request
- Нотификация о финальном статусе оплаты статического QR-кода
Запрос отправляется из ПШ Банка во внутреннюю систему ТСП на URL адрес, указанный в параметре «queryData.notificationUrl» при н
Метод «qrc/notification»
• Описание параметров запроса:
Код ключа Тип данных required Назначение
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 (ans) y Идентификатор плательщика (маскированный номер телефона плательщика).
kzo String (ans 1-128) y Контрольное Значение Операции СБП.
Формируется ОПКЦ СБП. Присутствует при условии, что Операция СБП C2B по запрашиваемом
="ACWP»).
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка.
TermNo String (an-20) y Уникальный идентификатор терминала.
CreditDatePos String (ans 1-256) o Дата операции, установленная Банком Получателя в ходе обработки уведомления НСПК.
• Примерный формат запроса:
7 "payload": "https://qr.nspk.ru/AS10000NJTDV88TN82CRT8CG1AU690OF",
8 "payrrn": "000051992395",
9 "qrcId": "AS10000NJTDV88TN82CRT8CG1AU690OF",
10 "status": "CREATED"
11 }
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
1 {
2 "command":"qrc/notification",
3 "qrcId":"AS10000NJTDV88TN82CRT8CG1AU690OF",
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 3/9
• ВС ТСП отвечает http-кодом «200» — успешное получение нотификации, или ошибкой. В настоящий момент ответ ВС не обрабатывается шлюзом Агента ТСП. Обработка ответов ТСП сейчас находится в разработк В случае добавления со стороны НСПК дополнительных параметров уведомления, система, принимающая их от шлюза Альфа-Банк неожиданные параметры как ошибочный запрос.
- Запрос проведения возврата по успешной оплате по статическому QR-коду
Возврат по СБП состоит из 2х последовательных запросов:
• GetQRCreversalData — проверка возможности проведения возврата;
• QRCreversal — выполнение непосредственно самого возврата.
В случае если ТСП инициирует выполнение повторных операций СБП B2C по одной и той же операции СБП C2B, то допускается не б операций СБП B2C в течение одного операционного дня.
3.1. Запрос возможности проведения возврата
Запрос GetQRCreversalData направляется ТСП в Банк для проверки возможности возврата по ранее оплаченному QR-коду и получен
Метод GetQRCreversalData
• Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1… 50)
y Тип запроса. Константа GetQRCreversalData».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcId String (an-32) y Идентификатор QR-кода.
trxId String (an-32) y Уникальный идентификатор платежа в НСПК.
trxDT String (n-14) o Дата и время отменяемого платежа.
amount Number o Сумма возврата в минорных единицах (копейках). Если сумма возврата не передана, то значение будет принято зн
возвратов.
currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»). В случае пустого значения валюта будет взята из данных о
messageID String (ans-
o Уникальный идентификатор сообщения, GUID. Только латинские символы!
Примечание: Терминалы с подключенным сканером и распознаванием QR-кодов могут получить «qrcId», распарсив строку QR-кода соответствует полю «payload».
• Примерный формат запроса:
4 "trxId":"A31040920067662400000550448AD7B3",
5 "status":"ACWP",
6 "amount":"10000",
7 "timestamp":"2023-04-14T09:20:06.000Z",
8 "payerId":"*********1779",
9 "kzo":"580d2f38370f378db5915c047ba7b72014327ce455caa927b2488f224926daac85e82984c889d66e79dad8039ccdefd
10 "payrrn":"000051992395",
11 "TermNo":"90080567",
12 "CreditDatePos":"20230414"
13 }
{
"command":"GetQRCreversalData",
"TermNo":"90080567",
"qrcId":"AS10000NJTDV88TN82CRT8CG1AU690OF",
"trxId":"A31040920067662400000550448AD7B3",
"trxDT":"20230414062006",
"amount":"10000",
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 4/9
• Описание параметров ответа:
Код ключа Тип данных 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 Уникальный идентификатор платежа в НСПК.
*, ** Таблица возможных кодов ответа приведена в приложении 2.
• Примерный формат ответа:
• 200 ОК
Примечание:
• Текстовые данные передаются в формате urlencoded;
• В случае получения "message»: «Получен отказ на запрос возврата. Статус Recall, ErrDebetMerchant: KSM0284 Invalid special cond счёт ТСП. Он должен быть положительным и без ограничений.
• 400 Bad Request
"currency":"RUB",
"messageID":"message"
}
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "message": "OK",
5 "messageID": "message",
6 "payerBnkBIC": "044525593",
7 "payerBnkName": "%u0410%u043B%u044C%u0444%u0430%20%u0411%u0430%u043D%u043A",
8 "payerId": "*1779",
9 "payerPam": "%u0424%u0421%u0418",
10 "payrrn": "000051992395",
11 "qrcId": "AS10000NJTDV88TN82CRT8CG1AU690OF",
12 "trxDT": 20230414062006
13 "trxId": "A31040920067662400000550448AD7B3"
14 }
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 5/9
3.2. Запрос возврата оплаты по QR-коду
Запрос QRCreversal направляется ТСП в Банк для возврата по ранее произведенной оплате QR. Возврат производится только на сче возврата (метод GetQRCreversalData).
Метод QRCreversal.
• Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1… 50)
y Тип запроса. Константа «QRCreversal».
TermNo String (an-20) y Уникальный идентификатор терминала.
qrcId String (an-32) y Идентификатор QR-кода.
trxId String (an-32) y Уникальный идентификатор платежа в НСПК.
trxDT String (n-14) o Дата и время отменяемого платежа.
amount Number o Сумма платежа в минорных единицах (копейках). Если сумма возврата не передана, то значение будет
совершенных возвратов.
currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»). В случае пустого значения валюта будет взята
messageID String (ans-
o Уникальный идентификатор сообщения, GUID из сообщения «GetQRCreversalData». Обязательно если
queryData.notificationUrl String (ans-512) o Полный URL для получения уведомления о финальном статусе возврата QR-кода. Уведомление не про
- messageID — необходимо передавать точное значение, которые было указано в ответе на запрос GetQRCreversalData. Если значени запрос GetQRCreversalData с указанием messageID и затем использовать полученный GUID при запросе на возврат.
• Примерный формат запроса:
• Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ответ*.
TermNo String (an-20) y Уникальный идентификатор терминала.
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
1 {
2 "command":"QRCreversal",
3 "TermNo":"90080567",
4 "qrcId":"AS10000NJTDV88TN82CRT8CG1AU690OF",
5 "trxId":"A31040920067662400000550448AD7B3",
6 "trxDT":"20230414062006",
7 "amount":"10000",
8 "currency":"RUB",
9 "messageID":"message"
10 "queryData":
11 {
12 "notificationUrl":"http://sbp-refunds"
13 }
14 }
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 6/9
Код ключа Тип данных required Назначение
amount Number y Сумма платежа в минорных единицах (копейках).
currency String (ans-3) y Код валюты (для рублей должен передаваться «RUB»).
message String (ans-1024) y Расшифровка кода ответа.
messageID String (ans-1024) y/o Уникальный идентификатор сообщения, GUID. Только латинские символы!
trxDT String (n-14) y Дата и время совершенного возврата по Московскому времени (MSK).
Формат времени — ГГГГММДДччммсс.
trxId String (an-32) y Уникальный идентификатор операции возврата в НСПК.
payrrn String (n-12) y Референсный идентификатор запроса в системе Банка.
*, ** Таблица возможных кодов ответа приведена в приложении 2.
• Примерный формат ответа:
• 200 OK
Примечание: текстовые данные передаются в формате urlencoded.
• 400 Bad Request
{ "ErrorCode":"Код ответа", "message":"Расшифровка кода ответа" }
- Запрос статуса возврата СБП (B2C)
Метод «GetQRCreversalStatus» необходим ТСП для уточнения статуса операции B2C (метод QRCreversal).
В запросе «GetQRCreversalStatus» обязательно должна быть передана пара параметров:
- «payrrn» или «originalTrxId»
Один из параметров «payrrn» или «originalTrxId» используется для нахождения исходного платежа C2B.
- «trxId» или «messageID».
Один из параметров «trxId» или «messageID» используется для нахождения операции возврата B2C, по которому требуется уточнит
Метод «GetQRCreversalStatus»
• Описание параметров запроса:
Код ключа Тип данных required Назначение
command String (an-1…50) y Тип запроса. Константа «Ge
TermNo String (an-20) y Уникальный идентификатор
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%u043
7 "messageID": "message",
8 "payrrn": "000051992395",
9 "trxDT": 20230414093406,
10 "trxId": "B31071502287201D00001650448AD7B3"
11 }
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 7/9
Код ключа Тип данных required Назначение
payrrn String (n-12) y/o
(обязательно, если не передан параметр «originalTrxId»)
Значение параметра «payrrn
originalTrxId String (an-32) y/o
(обязательно, если не передан параметр «payrrn»)
Идентификатор исходной оп
trxId String (an-32) y/o
(обязательно, если не передан «messageID»)
Уникальный идентификатор
messageID String (ans-1024) y/o
(обязательно, если не передан «trxId»)
Значение параметра «messa
• Примерный формат запроса:
• Описание параметров ответа:
Код ключа Тип данных required Назначение
ErrorCode String (an-20) y Код ошибки*.
TermNo String (an-20) y Уникальный идентификатор терминала.
Url String (ans 1-512) o Полный URL получения уведомления для ТСП -значение параметра, переданного при запросе возврата Q
amount Number y Сумма Операции СБП в копейках. Целое, положительное число. Валюта операции — рубли РФ.
message String (ans-1024) y Описание результата выполнения запроса**.
messageID String (an-32) o Значение параметра «messageID» из запроса «QRCreversal».
originalQrcId String (an-32) y Идентификатор зарегистрированной Платежной ссылки СБП, по которому была выполнена исходная Опе
originalTrxId String (an-32) y Идентификатор исходной Операции СБП C2B.
payerId String (an-13) y Маскированный номер телефона Клиента-Получателя (Плательщика в исходной Операции C2B, кому дел
status String (an-4) y Статус операции возврата СБП (B2C):
ACWP — ACCEPTED операция завершена успешно;
RJCT — REJECTED операция отклонена;
NTST — Статус операции неизвестен.
trxDT String (n-14) y Дата и время выполнения Операции СБП B2C по сценарию «Возврат по Операции СБП C2B» (ГГГГММДД
trxId String (an-32) y Уникальный идентификатор операции возврата в НСПК.
*, ** Таблица возможных кодов ответа приведена в приложении 2.
• Примерный формат ответа:
{
"command": "GetQRCreversalStatus",
"TermNo": "90080567",
"payrrn": "000051992395",
"originalTrxId": "A31040920067662400000550448AD7B3",
"trxId": "B31071502287201D00001650448AD7B3",
"messageID":"message"
}
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 8/9
• 200 OK
Примечание: текстовые данные передаются в формате urlencoded.
• 400 Bad Request
1 {
2 "ErrorCode": 0,
3 "TermNo": 90080567,
4 "amount": 10000,
5 "message": "OK",
6 "messageID":"123Rersal_Num567",
7 "originalQrcId": "AS10000NJTDV88TN82CRT8CG1AU690OF",
8 "originalTrxId": "A31040920067662400000550448AD7B3",
9 "payerId": "*********1779",
10 "URL":"http://sbp-payment/status",
11 "status": "ACWP",
12 "trxDT": 20230414093406,
13 "trxId": "B31071502287201D00001650448AD7B3"
14 }
{
"ErrorCode":"Код ответа",
"message":"Расшифровка кода ответа"
}
12/23/25, 11:22 AM Статический QR-код
https://alfabank.ru/sme/payservice/sbp/docs/static/?rp-menuOpen=1 9/9