alfa-bank-sdk/docs/alfabank/qr_payout/5_cache_payment_link_SBP.md at be2aa4b8d3af894e027b88e981a7a36ae207d203

Hasan/alfa-bank-sdk

Fork 0

forked from apoloz/alfa-bank-sdk

Files

Anatoliy Poloz 6a9243d969 update docs

2026-06-08 11:43:18 +03:00

70 KiB

Raw Blame History

Кассовая платёжная ссылка

Кассовая платёжная ссылка СБП

Кассовая платёжная ссылка — это гибридное решение, которое объединяет в себе преимущества статического и динамического QR-

Благодаря данному решению сам QR-код не меняется, но в то же время сумма оплаты передаётся с кассы, плательщик не может её и

Для совершения оплаты по кассовой платёжной ссылке достаточно один раз распечатать QR-код и разместить его в удобной прикас покупки перед оплатой.

Для каждой кассы/терминала создается своя кассовая платёжная ссылка.

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

Запрос на регистрацию Кассовой платёжной ссылки СБП

Данный метод позволяет сгенерировать кассовую платёжную ссылку, которую в дальнейшем ТСП может распечатать в необходимо

Кроме того, метод предоставляет возможность привязывать, полученные от Банка NFC-таблички, к нужным кассам/терминалам.

Метод RegCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «RegCashQRc».

TermNo String (an-20) y Уникальный идентификатор терминала

mediaType String o Тип картинки QR-кода

width String o Ширина картинка QR-кода

height String o Высота картинка QR-кода

redirectUrl String (ans-1024) о Содержит ссылку для автоматического возврата в приложение или на сайт ТСП. Допускаю

Если все же требуется использовать в redirectUrl кириллические символы, необходимо пе

qrcId String (an-32) o Идентификатор QR-кода. Используется в случае, если необходимо привязать заранее зар

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных required Назн

ErrorCode String (an-20) y Код от

TermNo String (an-20) y Уникал

content String y Base6

{

"command":"RegCashQRc",

"TermNo":"90080567",

"mediaType":"image/png",

"width":"600",

"height":"600",

"redirectUrl": "https://exampletsp.io/qwertyui"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 1/28

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1

Код ключа Тип данных required Назн

mediaType String y Тип ка

message String (ans-1024) y Расши

payload String (1…999) y Плате

qrcId String (an-32) y Идент

status String (an-20) y Статус

*, ** Таблица возможных кодов ответа приведена в приложении 2.

*** Формат payload может быть двух видов:

• https://qr.nspk.ru/BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9;

• https://qr.nspk.ru/BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9?type=01&bank=100000000008&crc=2557

d) Примерный формат ответа:

• 200 ОК

Примечание: текстовые данные передаются в формате urlencoded.

• 400 Bad Request

Запрос на активацию Кассовой платёжной ссылки СБП

Запрос ActivateCashQRc направляется кассой/терминалом ТСП в Банк для активации Кассовой ссылки в целях ожидания оплаты пла

Метод ActivateCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…

y Тип запроса. Константа «ActivateCashQRc».

TermNo String (an-20) y Уникальный идентификатор терминала.

qrcId String (an-32) y Идентификатор QR-кода.

amount Number y Сумма платежа в минорных единицах (копейках).

{

"ErrorCode": 0,

"TermNo": 90080567,

"content": "iVBORw0KGgoAAAANSUhEUgVXne/ /B2Pwbvw1OqlrAAAAAElFTk…………………………....SuQmCC",

"mediaType": "image/png",

"message": "OK",

"payload": "https://qr.nspk.ru/BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"qrcId": "BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "CREATED"

}

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 2/28

https://qr.nspk.ru/BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9 https://qr.nspk.ru/BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9?type=01&bank=100000000008&crc=2557

Код ключа Тип данных required Назначение

currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»). Необязательный параметр, при отсутствии его з

OrderNumber String (ans-

o Номер заказа.

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

paymentPurpose String (ans-

o Назначение платежа.

queryData.notificationUrl String (ans-

o Полный URL для получения уведомления о финальном статусе оплаты QR-кода

Если параметр отсутствует, уведомление не производится.

qrTtl String (an-1…

o Период использования Кассовой ссылки в минутах. Необязательное поле.

Допустимый диапазон: 5-20.

Если поле «qrTtl» не передано, то за период использования Кассовой ссылки берется значение по ум

redirectUrl String (ans-

o Содержит ссылку для автоматического возврата в приложение или на сайт ТСП. Допускаются только

перекодировать их в соответствующий ASCII код, используя percent-encoded octets согласно RFC398

Блок для внесения д

Код ключа Тип данных required

extJsonParams Object o

JsonParam1 String (ans-250) o

JsonParam2 String (ans-250) o

... ... ...

JsonParam10 String (ans-250) o

Блок для передачи дополнительных идентификаторов ТСП в ежедневные реестры СБП. Функционал потребует дополнительной н

b) Примерный формат запроса:

1 {

2 "command":"ActivateCashQRc",

3 "TermNo":"90080567",

4 "qrTtl":"5",

5 "amount":"10000",

6 "currency":"RUB",

7 "paymentPurpose":"Назаначение платежа",

8 "OrderNumber":"FYI123456",

9 "redirectUrl": "https://alfabank.ru/sme/payservice/sbp/",

10 "extJsonParams":

11 {

12 "JsonParam1":"Value",

13 "JsonParam2":"Value",

14 "JsonParam3":"Value",

15 "JsonParam4":"Value",

16 "JsonParam5":"Value",

17 "JsonParam6":"Value",

18 "JsonParam7":"Value",

19 "JsonParam8":"Value",

20 "JsonParam9":"Value",

21 "JsonParam10":"Value"

22 },

23 "queryData":

24 {

25 "notificationUrl":"https://sbp-payments",

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 3/28

c) Описание параметров ответа:

Код ключа Тип данных

ErrorCode String (an-20)

TermNo String (an-20)

amount Number

currency String (ans-3)

message String (ans-1024)

paramsId String

paymentPurpose String (ans-140)

payrrn String (an-12)

qrcId String (an-32)

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 ОК

Примечание: текстовые данные передаются в формате urlencoded.

• 400 Bad Request

Примечание:

• При повторной активации прежние значения параметров Кассовой ссылки СБП заменяются на новые;

• Если Плательщик отсканирует QR-код активированной Кассовой ссылки СБП и перейдёт в Приложение Плательщика и при этом К совершить оплату;

• Если в запросе на активацию Кассовой ссылки СБП не будет передан параметр «amount», то ответ вернется с ошибкой — " RQ05019

• Если при активации Кассовой ссылки СБП значение периода использования выходит за пределы допустимого диапазона 1-20 мин значение периода использования Кассовой ссылки СБП — 1 минута, максимальное — 20.

• Если оплата с использованием Кассовой ссылки СБП имеет финальный статус RJCT (оплата не прошла), то ТСП может повторно а

26 }

27 }

1 {

2 "ErrorCode": 0,

3 "TermNo": 90080567,

4 "amount": 10000,

5 "currency": "RUB",

6 "message": "OK",

7 "paramsId": "BP10001UMBREG8GI9AFRVAD7S7GJEK6E",

8 "paymentPurpose": "%u041D%u0430%u0437%u043D%u0430%u0447%u0435%u043D%u0438%u0435 %u043F%u043B%u

9 "payrrn": "000056251465",

10 "qrcId": "BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9"

11 }

{

    "ErrorCode":"Код ответа",

    "message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 4/28

• Оплата с использованием Кассовой ссылки СБП невозможна, если: а) истек период использования активированной Кассовой ссылки СБП; б) кассовая ссылка СБП не была активирована вовсе или была деактивирована и не активирована вновь; в) оплата по ней уже происходит, при этом для очередной оплаты она не была активирована вновь.

Запрос деактивации Кассовой платёжной ссылки СБП

Запрос DelCashQRc направляется кассой/терминалом ТСП в Банк для досрочной деактивации Кассовой ссылки.

Если Плательщик решил отказаться от покупки и не намерен совершать оплату, когда кассовая ссылка уже была активирована, то о процедура оплаты. Деактивация Кассовой ссылки СБП влечет за собой отмену всех дальнейших действий для оплаты по активиров

Если кассовая ссылка была активирована, и по ней происходит оплата, то в ответе на запрос «Деактивация Кассовой ссылки СБП» ве

Метод DelCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required

command String (an-1…50) y

TermNo String (an-10) y

qrcId String(an-32) y

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

message String (ans-140) y

TermNo String (an-10) y

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

Примечание: текстовые данные передаются в формате urlencoded.

• 400 Bad Request

{

"command":"DelCashQRc",

"TermNo":"90080567",

"qrcId":"BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9"

}

{

    "ErrorCode": 0,

    "TermNo": 90080567,

    "message": "%u0417%u0430%u043F%u0440%u043E%u0441 %u043E%u0431%u0440%u0430%u0431%u043E%u0442%u043

}

{

"ErrorCode":"Код ответа",

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 5/28

Запрос статуса Кассовой платёжной ссылки СБП

• Направляется ТСП в Банк для проверки статуса ранее зарегистрированной кассовой ссылки, например, в целях проверки готовно

• Может быть направлен для проверки статуса после попытки активации, в случае, если на запрос активации не получен ответ от Н

• Успешный ответ содержит статус самой Кассовой ссылки, но не операции ее оплаты.

Метод GetCashQRCstatus

a) Описание параметров запроса:

Код ключа Тип данных required

command String (an-1…50) y

TermNo String (an-20) y

qrcId String (an-32) y

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных

ErrorCode String (an-20)

message String (ans-140)

status String

paramsId String (an-32)

merchantId String (12)

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

"message":"Расшифровка кода ответа"

}

{

"command": "GetCashQRCstatus",

"TermNo": "90080567",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9"

}

{

"ErrorCode": 0,

"merchantId":"MB0000009603",

"message":"Запрос обработан успешно",

"qrcId":"BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "WAITING_PAYMENT",

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 6/28

Примечание: текстовые данные передаются в формате urlencoded.

• 400 Bad Request

Запрос изменения параметров для зарегистрированной Кассовой платёжной ссылки СБП

Запрос позволяет изменить следующие параметры Кассовой ссылки СБП:

• Номер счёта юридического лица — «account»

• Номер терминала — «TermNo»

• Торгово-сервисную точку (ТСТ) — «merchantId»

• Ссылку для автоматического возврата в приложение или на сайт ТСП — «redirectUrl»

Смена счёта юридического лица

Метод ChangeAccForCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «ChangeAccForC

TermNo String (an-20) y Уникальный идентификатор терминала,

qrcId String (an-32) y Идентификатор Кассовой ссылки СБП

account String (n-32) y Новый счёт юридического лица

b) Примерный формат запроса для смены номера счёта Кассовой ссылки СБП:

c) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

TermNo String (an-20) y

account String (an-20) y

merchantId String (an-12) y

message String (ans-1024) y

"paramsId": "BP10001UMBREG8GI9AFRVAD7S7GJEK6E"

}

{

    "ErrorCode":"Код ответа",

    "message":"Расшифровка кода ответа"

}

{

"command":"ChangeAccForCashQRc",

"TermNo":"90080567",

"qrcId":"BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"account":"00000000000000001111"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 7/28

Код ключа Тип данных required

qrcId String(an-32) y

status String (an-4) o

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

• 400 Bad Request

Смена номера терминала/мерчанта для Кассовой ссылки СБП

При успешном выполнении запроса Кассовая ссылка СБП будет перенесена на новый терминал/мерчант

Метод ChangeAccForCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «ChangeAccForCashQRc»

TermNo String (an-20) y Уникальный идентификатор терминала, на который Кассовая с

qrcId String (an-32) y Идентификатор QR-кода

account String (n-32) y Счёт юридического лица, установленный для нового терминал

NewTermNo String (an-20) y Новый уникальный идентификатор терминала

NewMerchantId String (an-12) y/o Идентификатор новой ТСТ.

Поле обязательно, если терминал, на который переносится

b) Примерный формат запроса для переноса КС на новый терминал, зарегистрированный в рамках одной ТСТ:

{

"ErrorCode": 0,

"TermNo": 90080567,

"account": "00000000000000001111",

"merchantId": " MA0001111111",

"message": "OK",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "UPDATED"

}

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

{

"command":"ChangeAccForCashQRc",

"TermNo":"90080567",

"account":"00000000000000001111",

"qrcId":"BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"NewTermNo":"90011111"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 8/28

c) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

TermNo String (an-20) y

account String (an-20) y

merchantId String (an-12) y

message String (ans-1024) y

qrcId String(an-32) y

status String (an-4) o

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

• 400 Bad Request

e) Примерный формат запроса для переноса КС на новый терминал, зарегистрированный в другой ТСТ или в другом юридическом

f) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

TermNo String (an-20) y

account String (an-20) y

merchantId String (an-12) y

{

"ErrorCode": 0,

"TermNo": 90011111,

"account": "00000000000000001111",

"merchantId": " MA0001111111",

"message": "OK",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "UPDATED"

}

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

{

"command": "ChangeAccForCashQRc",

"TermNo": "90080567",

"account": "00000000000000002222",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"NewTermNo": "90022222",

"NewMerchantId": "MA0002222222"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 9/28

Код ключа Тип данных required

message String (ans-1024) y

qrcId String(an-32) y

status String (an-4) o

*, ** Таблица возможных кодов ответа приведена в приложении 2.

g) Примерный формат ответа:

• 200 OK

• 400 Bad Request

h) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

TermNo String (an-20) y

account String (an-20) y

merchantId String (an-12) y

message String (ans-1024) y

qrcId String(an-32) y

status String (an-4) o

*, ** Таблица возможных кодов ответа приведена в приложении 2.

Перенос кассовой ссылки на нового мерчанта со старым номером терминала

При успешном выполнении запроса Кассовая ссылка СБП будет перенесена на нового мерчанта вместе со старым терминало

Метод ChangeAccForCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «ChangeAccForC

TermNo String (an-20) y Уникальный идентификатор терминала,

{

"ErrorCode": 0,

"TermNo": 90022222,

"account": "00000000000000002222",

"merchantId": " MA0002222222",

"message": "OK",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "UPDATED"

}

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 10/28

Код ключа Тип данных required Назначение

qrcId String (an-32) y Идентификатор QR-кода

account String (n-32) y Счёт юридического лица, используемый

NewMerchantId String (an-12) y Идентификатор новой ТСТ

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

TermNo String (an-20) y

account String (an-20) y

merchantId String (an-12) y

message String (ans-1024) y

qrcId String(an-32) y

status String (an-4) o

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

• 400 Bad Request

Смена ссылки для автоматического возврата в приложение или на сайт ТСП

При успешном выполнении запроса будет изменено значение поля «redirectUrl», указанное при первоначальной регистрации К

{

"command": "ChangeAccForCashQRc",

"TermNo": "90080567",

"account": "00000000000000002222",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"NewMerchantId": "MA0002222222"

}

{

"ErrorCode": 0,

"TermNo": 90080567,

"account": "00000000000000002222",

"merchantId": " MA0002222222",

"message": "OK",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "UPDATED"

}

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 11/28

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «ChangeAccForCashQRc».

TermNo String (an-20) y Уникальный идентификатор терминала, на который кассовая ссылка/NFC-табличка была

qrcId String (an-32) y Идентификатор QR-кода

redirectUrl String (ans-1024) y Новая ссылка для автоматического возврата в приложение или на сайт ТСП.

Допускаются только символы в кодировке ASCII. Формат должен соответствовать пра

Если требуется использовать в redirectUrl кириллические символы, необходимо перек

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных required

ErrorCode String (an-20) y

TermNo String (an-20) y

account String (an-20) y

merchantId String (an-12) y

message String (ans-1024) y

qrcId String(an-32) y

status String (an-4) o

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

• 400 Bad Request

{

"command": "ChangeAccForCashQRc",

"TermNo": "90080567",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"redirectUrl": " https://alfabank.ru/sme/payservice/sbp/"

}

{

"ErrorCode": 0,

"TermNo": 90080567,

"account": "00000000000000002222",

"merchantId": " MA0002222222",

"message": "OK",

"qrcId": " BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

"status": "UPDATED"

}

{

"ErrorCode":"Код ответа",

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 12/28

Запрос на изменение номера терминала (TermNo) для зарегистрированной Кассовой платё

Данный запрос позволяет ТСП произвести смену номера терминала по ранее зарегистрированной Кассовой ссылке СБП на любой д может быть использован и для перепривязки кассовой ссылки на новое ЮЛ, ИП.

Метод ChangeTermNoForCashQRc

a) Описание параметров запроса:

Код ключа Тип данных required

command String (an-1…50) y

TermNo String (an-20) y

qrcId String (an-32) y

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных required Назначение

ErrorCode String (an-20) y Код ответа*

TermNo String (an-20) y Уникальный идентификатор терми

message String (ans-140) y Расшифровка кода ответа**

status String (an-4) y Статус выполнения перерегистрац

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

• 400 Bad Request

"message":"Расшифровка кода ответа"

}

{

"command": "ChangeTermNoForCashQRc",

"TermNo": "90080567",

"qrcId": "BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9"

}

{

"ErrorCode": 0,

"TermNo": 90080567,

"message": "OK",

"status": "UPDATED"

}

{

"ErrorCode": "Код ответа",

"message": "Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 13/28

Запрос статуса оплаты по Кассовой платёжной ссылке СБП

Запрос статуса GetQRCstatus направляется кассой/терминалом ТСП в Банк для получения статуса Операции оплаты выпущенного ра

Запрос статуса направляется не ранее, чем через 10 секунд после формирования QR-кода и не чаще чем каждые 3 секунды.

Успешный ответ на запрос статуса можно получить в течении 30 дней после совершения оплаты по данному QR-коду.

В случае, если срок хранения данных истек, то в ответе на запрос вернется:

Метод GetQRCstatus

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «GetQRCstatus».

TermNo String (an-20) y Уникальный идентификатор терминала.

payrrn String (n-12) y/o Референсный идентификатор запроса в системе Банка.

qrcId String (an-32) y/o Идентификатор QR-кода (обязательно, если не передан «pa

paramsId String (an-32) y/o Идентификатор параметров ссылки СБП (если передан qrcId

messageID String (ans-1024) o Уникальный идентификатор сообщения, GUID. Только латин

Примечание: для кассовой платежной ссылки должен быть передан один из параметров: payrrn или qrcId + paramsId. Передавать в з

b) Примерный формат запроса:

1-й вариант запроса:

2-й вариант запроса:

c) Описание параметров ответа:

Код ключа Тип данных required Назначение

ErrorCode String (an-20) y Код ответа*.

message String (ans-1024) y Расшифровка кода ответа**.

{

"ErrorCode":999,

"message":"Неизвестный код проблемы 999RQ05014"

}

{

"command":"GetQRCstatus",

"TermNo":"90080567",

"payrrn":"000056251465",

"messageID":"message"

}

{

"command":"GetQRCstatus",

"TermNo":"90080567",

"qrcId": "AS1R005G9DAOLK5L8S5OPR6HB23HSN0I",

"paramsId": "BP10001UMBREG8GI9AFRVAD7S7GJEK6E",

"messageID":"message"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 14/28

Код ключа Тип данных required Назначение

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) o Референсный идентификатор запроса в системе Банка. Значение возвращается если зап

CreditDatePos String (ans 1-256) o Дата операции, установленная Банком Получателя (ГГГГММДД)

TermNo String (an-20) y Уникальный идентификатор терминала.

amount Number y Сумма платежа в минорных единицах (копейках).

currency String (ans-3) o Код валюты (для рублей должен передаваться «RUB»).

Url String (ans 1-512) o Полный URL для получения уведомления ТСП о финальном статусе оплаты QR-кода. Зн

paramsId String (an-32) o Идентификатор активных значений параметров Платежной ссылки СБП. Передается, есл

payerId String (ans) 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-кода.

d) Примерный формат ответа:

• 200 OK

1 {

2 "ErrorCode": 0,

3 "message": "OK",

4 "qrcId": "BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

5 "status": "ACWP",

6 "trxId": "A30180803159571F0000097B3DA2D4A7",

7 "trxDT": "20230118080315",

8 "payrrn": "000056251465",

9 "CreditDatePos": "20230118",

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 15/28

Примечание:

• Текстовые данные передаются в формате urlencoded.

• В поле " trxDT» содержится дата и время транзакции на ПШ Банка в формате ГГГГММДДччммсс.

В случае получения значения trxId = null необходимо повторить запрос. Отсутствие значения означает, что в СБП еще нет успешного

• 400 Bad Request

Нотификация ТСП о финальном статусе оплаты по Кассовой платёжной ссылке СБП

Запрос отправляется из ПШ Банка во внутреннюю систему ТСП на 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 Уникальный идентификатор платежа в Н

paramsId 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) o Контрольное Значение Операции СБП. Ф

Присутствует при условии, что Операция

payrrn String (n-12) y Референсный идентификатор запроса в

TermNo String (an-20) y Уникальный идентификатор терминала

10 "TermNo": 90080567,

11 "amount": 10000,

12 "currency": "RUB",

13 "Url":"https://sbp-payments",

14 "paramsId": "BP10001UMBREG8GI9AFRVAD7S7GJEK6E",

15 "payerId": "*********1234",

16 "kzo": "b02bf0fb819dcc6249f1f6be81da28062236febcb25774a29ebdd770f2a35ba29fa038e459c0845ade1ef2

17 "messageID ":"message"

18 "merchantId": "MB0000009603"

19 }

{

    "ErrorCode":"Код ответа",

    "message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 16/28

Код ключа Тип данных required Назначение

CreditDatePos String (ans 1-256) o Дата операции, установленная Банком П

b) Примерный формат запроса:

c) ВС отвечает http-кодом «200» — успешное получение нотификации, или ошибкой.

В настоящий момент ответ ВС не обрабатывается шлюзом Агента ТСП. Обработка ответов ТСП находится в разработке.

В случае добавления со стороны НСПК дополнительных параметров уведомления, система принимающая их от шлюза Альфа-Банка

Запрос операций по Кассовой платёжной ссылке СБП

• Запрос позволяет выполнить поиск всех операций оплаты и возвратов, произведенных по определенной кассовой платежной ссы

• В ответе платежный шлюз Банка возвращает результат обработки запроса с разбивкой по массивам payments (оплаты) и refunds (в

Метод «GetCashQrcId»

a) Описание параметров запроса:

Код ключа Тип данных required

command String (an-1…50) y

TermNo String (an-20) y

qrcId String (an-32) y

dateFrom date-time y

dateTo date-time y

Примечание: Временной диапазон dateFrom — dateTo не должен быть более семи календарных дней. Время в параметре dateFrom д

b) Примерный формат запроса:

c) Описание параметров ответа:

1 {

2 "command":"qrc/notification",

3 "qrcId":"BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

4 "trxId":"A30180803159571F0000097B3DA2D4A7",

5 "paramsId":"BP10001UMBREG8GI9AFRVAD7S7GJEK6E",

6 "status":"ACWP",

7 "amount":"10000",

8 "timestamp":"2023-02-07T08:35:31.102Z",

9 "payerId":"*********1234",

10 "kzo":"d4d45d9db80b29fec2aacbfaf778edc49ff615c13021a2bf5a05f35d8afbcc76f84ceda7598695956c1d5168b1f

11 "payrrn":"000056251465",

12 "TermNo":"90080567",

13 "CreditDatePos":"20230207"

14 }

{

"command": "GetCashQrcId",

"TermNo": "90080567",

"qrcId": "BS10005FR8SV6EI9931BIQGPSUEG8ELL",

"dateFrom": "2023-03-12T17:30:09",

"dateTo": "2023-03-12T23:25:15"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 17/28

Код ключа Тип данных required Назначение

ErrorCode String (an-20) y Код ответа*.

TermNo String (an-20) y Уникальный

payments array o **Массив пла

operationId string y id платежа в

status string (enum) y Статус оплат

— SUCCESS,

— REJECTED

reason string o Описание со

amount number y Сумма в коп

date date-time y Формат YYY

refunds array o **Массив воз

refundId string y id возврата в

date date-time y Формат YYY

status string (enum) y Статус возвр

— SUCCESS,

REJECTED,

reason string o Описание пр

amount number y Сумма в коп

Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

Примечание: текстовые данные передаются в формате urlencoded.

• 400 Bad Request

1 {

2 "ErrorCode": 0,

3 "TermNo": 90080567,

4 "payments": [

5 {

6 "amount": 10000,

7 "date": "2024-02-07T14:08:13",

8 "operationId": "A4038110812414010000020011180902",

9 "reason": "Запрос обработан успешно",

10 "status": "SUCCESS"

11 }

12 ],

13 "refunds": [

14 {

15 "amount": 10000,

16 "date": "2024-02-07T14:19:36",

17 "reason": "Платёж проведён",

18 "refundId": "A4038111858413010000020011180902",

19 "status": "SUCCESS"

20 }

21 ]

22 }

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 18/28

e) При проверке обязательности заполнения параметров запроса, в случае, если какой-либо параметр не заполнен в ответе вернуть

ErrorCode message

"3" Не передан обязательный параметр dateFrom/dateTo

"16" Не передан параметр TermNo

"41" Не передан параметр qrcId

"301" Превышен временной диапазон dateFrom-dateTo

Запрос проведения возврата по успешной оплате по Кассовой платёжной ссылке СБП

Возврат по СБП состоит из 2х последовательных запросов:

• GetQRCreversalData — проверка возможности проведения возврата;

• QRCreversal — выполнение непосредственно самого возврата.

В случае если ТСП инициирует выполнение повторных операций СБП B2C по одной и той же операции СБП C2B, то допускается не б

Возврат в один этап. При направлении запроса «QRCReversal», с заполненным полем messageID будет произведен возврат в один

10.1. Запрос возможности проведения возврата

Запрос GetQRCreversalData направляется ТСП в Банк для проверки возможности возврата по ранее оплаченному QR-коду и получен

Метод GetQRCreversalData

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «GetQRCreversalData».

TermNo String (an-20) y Уникальный идентификатор терминала.

payrrn String (n-12) y/o Референсный идентификатор запроса в системе Банка (обязательно, если не

trxId String (an-32) y/o Уникальный идентификатор платежа в НСПК (обязательно, если не передан «p

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

Примечание:

• Для поиска оригинальной транзакции обязательным является один из параметров: «payrrn» или «trxId»;

• Терминалы с подключенным сканером и распознаванием QR-кодов могут получить «qrcId», распарсив строку QR-кода с чека опла

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 19/28

b) Примерный формат запроса:

c) Описание параметров ответа:

Код ключа Тип данных required Назначение

ErrorCode String (an-20) y Код ответа*.

TermNo String (an-20) y Уникальный идентификатор терминала.

message String (ans-140) y Расшифровка кода ответа**.

messageID String (an-1…50) y/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 Дата и время платежа в AnyWay (ГГГГММДДччммсс)

trxId String (an-32) y Уникальный идентификатор платежа в НСПК

restAmount Number (с двумя знаками после точки) o Сумма доступного остатка к возврату.

Если в запросе передано значение "ReturnRestAmount" : true, то в ответе д

*, ** Таблица возможных кодов ответа приведена в приложении 2.

d) Примерный формат ответа:

• 200 OK

1 {

2 "command":"GetQRCreversalData",

3 "TermNo":"90080567",

4 "payrrn":"000056251465",

5 "trxId": "A30180803159571F0000097B3DA2D4A7",

6 "trxDT":"20230416082214",

7 "amount":"10000",

8 "currency":"RUB",

9 "messageID":"f9aa54ff-a615-44b8-aa6c-acab655c89f8",

10 "ReturnRestAmount": true

11 }

1 {

2 "ErrorCode": 0,

3 "TermNo": 90080567,

4 "message": "OK",

5 "messageID":"message",

6 "payerBnkBIC": "044525225",

7 "payerBnkName": "Альфа-Банк",

8 "payerId": "*1234",

9 "payerPam": "ИИИ",

10 "payrrn": "000056251465",

11 "qrcId": "BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

12 "trxDT": 20230118124954,

13 "trxId": "A3018124954175080000087B3DA2D4A7",

14 "restAmount":"99.87"

15 }

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 20/28

Примечание:

• Текстовые данные передаются в формате urlencoded;

• В случае получения "message»: «Получен отказ на запрос возврата. Статус Recall, ErrDebetMerchant: KSM0284 Invalid special cond

• 400 Bad Request

10.2. Запрос возврата оплаты

Запрос QRCreversal направляется ТСП в Банк для возврата по ранее произведенной оплате QR. Возврат производится только на сче

Метод QRCreversal.

a) Описание параметров запроса:

Код ключа Тип данных required Назначение

command String (an-1…50) y Тип запроса. Константа «QRCreversal».

TermNo String (an-20) y Уникальный идентификатор терминала.

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. Если значени на возврат.

{

    "ErrorCode":"Код ответа",

    "message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 21/28

** Блок для передачи дополнительных идентификаторов ТСП в ежедневные реестры СБП. Функционал потребует дополнительной

Примечание: Для поиска оригинальной транзакции обязательным является один из параметров: «payrrn» или «trxId».

b) Примерный формат запроса:

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

1 {

2 "command":"QRCreversal",

3 "TermNo":"90080567",

4 "payrrn":"000056251465",

5 "trxId":"A30180803159571F0000097B3DA2D4A7",

6 "trxDT":"20230416082214",

7 "amount":"10000",

8 "currency":"RUB",

9 "messageID":"f9aa54ff-a615-44b8-aa6c-acab655c89f8",

10 "extJsonParams":

11 {

12 "JsonParam1":"Value",

13 "JsonParam2":"Value",

14 "JsonParam3":"Value",

15 "JsonParam4":"Value",

16 "JsonParam5":"Value",

17 "JsonParam6":"Value",

18 "JsonParam7":"Value",

19 "JsonParam8":"Value",

20 "JsonParam9":"Value",

21 "JsonParam10":"Value"

22 },

23 "queryData":

24 {

25 "notificationUrl":"http://sbp-refunds/"

26 },

27 "ReturnRestAmount": true

28 }

1 {

2 "ErrorCode": 0,

3 "TermNo": 90080567,

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 22/28

Примечание: текстовые данные передаются в формате urlencoded.

• 400 Bad Request

Запрос статуса возврата СБП (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) Примерный формат запроса:

4 "amount": 10000,

5 "currency": "RUB",

6 "message": "%u0421%u0442%u0430%u0442%u0443%u0441%20%u0432%u044B%u044F%u0441%u043D%u0435%u043D%

7 "messageID":"message"

8 "payrrn": "000056251465",

9 "trxDT": 20230614061308,

10 "trxId": "B3018130524291090000167B3DA2D4A7",

11 "restAmount": "99.87"

12 }

{

    "ErrorCode":"Код ответа",

    "message":"Расшифровка кода ответа"

}

{

"command":"GetQRCreversalStatus",

"TermNo":"90080567",

"payrrn":"000056251465",

"originalTrxId":"A30180803159571F0000097B3DA2D4A7",

"trxId":"B3018130524291090000167B3DA2D4A7",

"messageID":"message"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 23/28

c) Примерный формат ответа:

Код ключа Тип данных required Назначение

ErrorCode String (an-20) y Код ошибки*.

TermNo String (an-20) y Уникальный идентификатор терминала.

Url String (ans 1-512) o Полный URL получения уведомления для ТСП — значение параметра,

amount Number y Сумма Операции СБП в копейках. Целое, положительное число. Валют

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

1 {

2 "ErrorCode": 0,

3 "TermNo": 90080567,

4 "amount": 10000,

5 "message": "OK",

6 "messageID": "message"

7 "originalQrcId": "BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

8 "originalTrxId": "A30180803159571F0000097B3DA2D4A7",

9 "payerId": "*********1234",

10 "status": "ACWP",

11 "trxDT": 20230614061308,

12 "trxId": "B3018130524291090000167B3DA2D4A7"

13 }

{

"ErrorCode":"Код ответа",

"message":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 24/28

Запрос истории возвратов по определённой транзакции СБП C2B

Запрос позволяет ТСП проверить все совершённые возвраты по определённой транзакции СБП C2B.

В ответе на запрос возвращаются как успешные, так и неуспешные попытки возвратов.

Метод GetQRCreversalHistory

a) Описание параметров запроса:

Код ключа Тип данных 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»:

{

"command":"GetQRCreversalHistory",

"TermNo":"90080567",

"payrrn":"000000002212"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 25/28

• 200 ОК

• 400 Bad Request

e) Примерный формат ответа «NTST»:

• 200 ОК

• 400 Bad Request

f) Примерный формат ответа при отсутствии возвратов по транзакции СБП C2B:

• 200 OK

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": "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":"Расшифровка кода ответа"

}

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 26/28

Декодирование значения поля «message» - «По данной оплате возвраты не найдены».

• 400 Bad Request

Нотификация о финальном статусе возврата по Кассовой платёжной ссылке СБП

Метод «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": 0,

    "message": "%u041F%u043E%20%u0434%u0430%u043D%u043D%u043E%u0439%20%u043E%u043F%u043B%u0430%u0442

}

{

    "ErrorCode":"Код ответа",

    "message":"Расшифровка кода ответа"

}

1 {

2 "command":"b2c-refund/notification",

3 "messageID":" message",

4 "TermNo":"90080567",

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 27/28

В ответ ожидается:

• http-код «200» — Успешный ответ (Уведомление получено);

• http-код «500» — Внутренняя ошибка.

c) Примерный формат запроса (по отклоненному возврату):

В ответ ожидается:

• http-код «200» — Успешный ответ (Уведомление получено);

• http-код «500» — Внутренняя ошибка.

d) ВС ТСП отвечает http-кодом «200» — успешное получение нотификации, или ошибкой.

В случае добавления со стороны НСПК дополнительных параметров уведомления, система, принимающая их от шлюза Альфа-Банка,

5 "originalQrcId":"BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

6 "originalTrxId":"A3018124954175080000087B3DA2D4A7",

7 "trxId":"B3018130524291090000167B3DA2D4A7",

8 "trxDT":"20230614061308",

9 "status":"ACWP",

10 "amount":"10000",

11 "ErrorCode":"0",

12 "message":"OK",

13 "payerId":"*********1234",

14 "agentRefundRequestId":"00000000000000000182_abcd1994383",

15 "opkcRefundRequestId":"BR10000OKEISOIPM8ST8TBLQHIN9R185"

16 }

1 {

2 "command":"b2c-refund/notification",

3 "TermNo":"90080567",

4 "originalQrcId":" BS1R001P1UIGJCFJ9RDQ8974M1I4CJO9",

5 "originalTrxId":" A3018124954175080000087B3DA2D4A7",

6 "trxId":"A3024113609260070000086B8426B817",

7 "trxDT":"20230614061308",

8 "status":"RJCT",

9 "amount":"10000",

10 "ErrorCode":"0",

11 "message":"OK",

12 "payerId":"*********1234"

13 }

12/23/25, 11:24 AM Кассовая платёжная ссылка СБП

https://alfabank.ru/sme/payservice/sbp/docs/paylink/?rp-menuOpen=1 28/28

70 KiB Raw Blame History Unescape Escape

70 KiB

Raw Blame History