alfa-bank-sdk/_docs/alfabank/qr_payout/7_digital_rubble.md at e23e2ea6df9dcaffcfa5ff1ab20f9d053f79d1aa

Hasan/alfa-bank-sdk

Fork 0

forked from apoloz/alfa-bank-sdk

Files

Anatoliy Poloz 5934073aa0 doc(base): libs docs added

2026-01-16 14:52:35 +03:00

44 KiB

Raw Blame History

Цифровой Рубль

Цифровой рубль

Цифровой рубль — это цифровая форма рубля.

Сейчас у нас есть наличная (банкноты и монеты) и безналичная (деньги на счетах) форма национальной валюты, а в дополнение к ни

Счета цифрового рубля будут открываться на платформе Центробанка. На этих счетах будет храниться цифровой рубль.

Операции с цифровыми рублями будут проходить на ПЦР.

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

По эквайрингу прием ЦР осуществляется в рамках Универсального платёжного кода

Динамический QR-код:

1.1. Запрос регистрации динамического УПК (универсального одноразового платёжного кода)

• Сгенерировать универсальный одноразовый платёжный код возможно с помощью уже существующего метода «GetQRCd». Сгенерированный QR-код возможно оплатить как через СБП, так и с использованием ЦР. При этом в настройках ТСП на ПШ Банка обязательно должен быть указан счет ЦР

• Также универсальный одноразовый платёжный код возможно сгенерировать с помощью отдельного метода «ReqUniQr». Сгенерированный QR-код возможно оплатить как через СБП, так и с использованием ЦР. При этом в настройках ТСП на ПШ Банка обязательно должен быть указан счет ЦР

Запрос «ReqUniQr» направляется ТСП в Банк для выполнения запроса «Регистрация универсальной платёжной ссылки» API СБП.

В ответе ПШ Банка возвращает результат обработки запроса и, в случае успешной обработки — значения параметров, полученных в

• image (изображение)

• mediaTypeR (расширение QR-кода)

• payload (платёжная ссылка)

• uniQrId (Идентификатор Платёжной ссылки)

• status (Статус регистрации Платёжной ссылки. Единственное допустимое значение = «CREATED»).

Метод ReqUniQr

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

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

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

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

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

Обязательна при значении uniQrType = 02

mediaType String o Расширение QR‐кода

width String o Ширина картинки QR‐кода (только числовое значение)

height String o Высота картинки QR‐кода (только числовое значение)

uniQrType String (n‐2) y Тип платёжной ссылки:

• 01 — многоразовая

• 02 — одноразовая

12/23/25, 11:24 AM Цифровой рубль

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

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 https://sbp.nspk.ru/uniqr?ysclid=mhajjmr4i0196202211 https://alfabank.ru/sme/payservice/sbp/docs/dynamic/?rp-menuOpen=1#dynemic_qr

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

paymentPurpose String (ans‐140) o Назначение платежа

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

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

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

RFC3986

paymentPageUrl String (ans‐1024) o Ссылка для перенаправления Покупателя на Платёжную страницу Участника Сервиса УПК

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

qrTtl String (an‐1…6) o Минимальное значение срока использования созданной динамической платёжной ссылки в целых мин

fraudScore String (an‐16) o Индикатор Подозрительной Операции Агента ТСП

queryData.notificationUrl String (ans‐512) o Полный URL для получения уведомления о финальном статусе оплаты QR‐кода

Если требуется сформировать динамический QR-код под определенного Плательщика, то необходи

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

queryData.SenderFIO String (an‐140) o Фамилия, Имя и Отчество Плательщика, не являет

queryData.SenderID String (an-11…13) o Идентификатор Плательщика

queryData.SenderBankBIC String (n‐9) o Банковский Идентификационный Код Банка Плате

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

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

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

ErrorCode String (an‐20) y Код ответа:

0 — успешное выполнение запроса

иначе — код ошибки и её расшифровка в поле message*

message String (ans‐1024) o Расшифровка кода ответа — если ErrorCode не равен 0**

payload String (1…999) o Платёжная ссылка — если ErrorCode = 0

1 {

2 "command":"ReqUniQr",

3 "TermNo":"90080567",

4 "amount":"10000",

5 "uniQrType":"02",

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

7 "paymentPageUrl":"https://alfabank.ru/sme/payservice/sbp/",

8 "mediaType":"image/png",

9 "width":"600",

10 "height":"600",

11 "qrTtl":"2",

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

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

14 "fraudScore":"0000000000000000",

15 "queryData":

16 {

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

18 "SenderFIO":"Иванов|Иван|Иванович",

19 "SenderID":"0079123456789",

20 "SenderBankBIC":"44525593"

21 }

22 }

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 2/13

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

payrrn String (n‐12) o Референсный номер платежа — если ErrorCode = 0

mediaTypeR String o Расширение QR-кода — если ErrorCode = 0

uniQrId String (an‐32) o Идентификатор Платёжной ссылки — если ErrorCode = 0

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

status String (an‐20) o Статус регистрации Платёжной ссылки = «CREATED» — если Error

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

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

• 200 OK

• 400 Bad Request

1.2. Запрос статуса оплаты по динамическому УПК

• Статус оплаты универсального одноразового платёжного кода возможно проверить с помощью уже существующего метода «GetQ При этом, в ответе к уже существующим статусам, добавляется еще два новых статуса для ЦР: «ENDD» и «ACDR»

• Также статус оплаты возможно проверить с помощью отдельного метода «GetUniQrStatus»

Метод GetUniQrStatus

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

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

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

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

uniQrIds String y Массив идентификаторов Одноразовых Платёжных ссылок (uniQrId), статус которых х

Максимальное количество идентификаторов Одноразовых Платёжных ссылок в одно

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

1 {

2 "ErrorCode":"0",

3 "message":"Запрос выполнен",

4 "image":"iVBORw0KGgoAAAANS…AAASUVORK5CYII=",

5 "messageID":"message",

6 "payload":"https://qr.nspk.ru/BD10006PV41C82I48OAODKVDFF0IK9SE",

7 "payrrn":"000000002235",

8 "uniQrId":"BD10006PV41C82I48OAODKVDFF0IK9SE",

9 "mediaTypeR":"image/png",

10 "status":"CREATED"

11 }

{

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

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

}

1 {

2 "command": "GetUniQrStatus",

3 "TermNo": "agttest321",

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 3/13

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

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

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

ErrorCode String (an‐20) y Код ответа:

0 — успешное выполнение запроса

иначе — код ошибки и её расшифровка в поле message*

message String (ans‐1024) o Расшифровка кода ответа — если ErrorCode не равен 0**

data String o Блок данных в формате JSON (массив Record)*** — если ErrorCode

messageID String (ans‐1024) o Уникальный идентификатор сообщения, GUID — если ErrorCode = 0

status String (an‐20) o Статус регистрации Платёжной ссылки = «CREATED» — если ErrorC

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

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

uniQrId String (an‐32) Идентификатор Одноразовой Платёжной ссылки

code String (7) Код ответа для указанной Одноразовой Платёжной ссылки

message String (1…255) Текстовое описание кода ответа для указанной Одноразовой Платёжной ссылки

paymentServiceId String (12) Идентификатор способа приёма платежа, который использовался для оплаты указанной Одноразовой Платёжной сс

Будет отсутствовать в ответе при значении параметра status = «NTST» и будет заполнен при любых других значениях

status String (4) Текущий статус Одноразовой Платёжной ссылки. Допустимые значения:

«NTST» (NOT_STARTED): платёж не инициирован
«RCVD» (RECEIVED): инициирован платёж
«ACWP» (ACCEPTED): платёж успешно выполнен
«RJCT» (REJECTED): платёж отклонён
«ENDD»: платёж с расчётами в ЦР обработан, но результат выполнения неизвестен (успех или отказ)
«ACDR»: передаётся статус (аналог «ACWP»), указанный в настройке ACWPstatusDR. Используется в отдельных п

Может принимать значения:

• «ENDD» передаётся в случае, если:

• с использованием указанной Одноразовой Платёжной ссылки была выполнена Операция ЦР C2B (paymentSe

• нет уведомления, но уже был запрос статуса, и в нём был получен «ENDD» (если ссылка была сформирована

• «ACWP» и «RJCT» только в том случае, если с использованием указанной Одноразовой Платёжной ссылки был

• «ACDR» передаётся статус, если есть уведомление от ПлЦР об оплате (если ссылка была сформирована как un

trxId String (32) Идентификатор Операции СБП будет заполнен только при соблюдении следующих условий:

• paymentServiceId = «PS0000000001»

4 "uniQrIds":

5 [

6 "AD2000670LSS7DN18SJQDNP4B05KLJL1",

7 "AD2000670LSS7DN18SJQDNP4B05KLJL2",

8 "AD2000670LSS7DN18SJQDNP4B05KLJL3",

9 "AD2000670LSS7DN18SJQDNP4B05KLJL4",

10 "AD2000670LSS7DN18SJQDNP4B05KLJL5"

11 ]

12 }

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 4/13

https://wiki.finstream.ru/pages/viewpage.action?pageId=153813196#id-%D0%A8%D0%BB%D1%8E%D0%B7FastPayAgentDR(%D0%9F%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%BD%D0%B0%D1%8F%D1%81%D1%81%D1%8B%D0%BB%D0%BA%D0%B0%D0%A1%D0%91%D0%9F/%D0%A6%D0%A0(%D0%A6%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%BE%D0%B9%D1%80%D1%83%D0%B1%D0%BB%D1%8C)%D0%B4%D0%BB%D1%8F%D0%90%D0%B3%D0%B5%D0%BD%D1%82%D0%B0%D0%A2%D0%A1%D0%9F)-%D0%91%D0%B8%D0%B7%D0%BD%D0%B5%D1%81-%D0%BF%D1%80%D0%BE%D1%86%D0%B5%D1%81%D1%81AWGW.FastPayAgentDR.BProcess

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

• status = «ACWP» или «RJCT»

kzo String (1…128) Контрольное значение Операции СБП будет заполнено только при соблюдении следующих условий:

• paymentServiceId = «PS0000000001»

• status = «ACWP»

payrrn String (n‐12) Референсный номер платежа — если ErrorCode = 0

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

• 200 OK

• 400 Bad Request

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

1 {

2 "ErrorCode": "0",

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

4 "data": [

5 {

6 "qrcId": "AD2000670LSS7DN18SJQDNP4B05KLJL1",

7 "code": "RQ00000",

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

9 "paymentServiceId": "PS0000000002",

10 "status": "ENDD",

11 "trxId": null,

12 "kzo": null

13 },

14 {

15 "qrcId": "AD2000670LSS7DN18SJQDNP4B05KLJL2",

16 "code": "RQ00000",

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

18 "paymentServiceId": "PS0000000001",

19 "status": "ACWP",

20 "trxId": "A1A2S3D5F6G7H8J9K0C4S5C6D7V5D1K3",

21 "kzo": "FDOS4JUETLYT639ADAFZ4GAUY9VSM2TG2Y595LQ20EKQF3JM1CIV4ZTZYA1EYIMFMEJSRB2UR7KATMA2

22 },

23 {

24 "qrcId": "AD2000670LSS7DN18SJQDNP4B05KLJL4",

25 "code": "RQ00000",

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

27 "paymentServiceId": null,

28 "status": "NTST",

29 "trxId": null,

30 "kzo": null

31 },

32 {

33 "qrcId": "AD2000670LSS7DN18SJQDNP4B05KLJL5",

34 "code": "RQ05014",

35 "message": "Указанное значение uniQrId не найдено",

36 "paymentServiceId": null,

37 "status": null,

38 "trxId": null,

39 "kzo": null

40 }

41 ]

42 }

{

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

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

}

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 5/13

2.1 Запрос регистрации кассового УПК (универсального многоразового платёжного кода)

• Сгенерировать универсальный многоразовый платёжный код возможно с помощью уже существующего метода «RegCashQRc». Сгенерированный QR-код возможно оплатить как через СБП, так и с использованием ЦР. При этом в настройках ТСП на ПШ Банка обязательно должен быть указан счет ЦР

• Также универсальный многоразовый платёжный код возможно сгенерировать с помощью отдельного метода «RegCashUniQr». Сгенерированный QR-код возможно оплатить как через СБП, так и с использованием ЦР. При этом в настройках ТСП на ПШ Банка обязательно должен быть указан счет ЦР

Метод ReqUniQr

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

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

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

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

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

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

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

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

RFC3986

paymentPageUrl String (ans‐1024) o Ссылка для перенаправления Покупателя на Платёжную страницу Участника Сервиса УПК

mediaType String o Расширение QR‐кода УПК

width String o Ширина картинки QR‐кода (только числовое значение)

height String o Высота картинки QR‐кода (только числовое значение)

qrcId String (32) o Идентификатор Многоразового УПК, предварительно зарегистрированный с использованием мето

Если Банк ТСП передаст в запросе параметр qrcId, Оператор Сервиса УПК использует значение это

параметр qrcId будет отсутствовать, Оператор Сервиса УПК сформирует новое значение идентифи

Зарегистрировать Кассовый УПК с определенным значением qrcId может только тот Банк ТСП, кот

API «Получение идентификаторов для Многоразовых УПК»

queryData.notificationUrl String (ans‐512) o Полный URL для получения уведомления о финальном статусе оплаты QR-кода

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

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

1 {

2 "command":"ReqCashUniQr",

3 "TermNo":"90080567",

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

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

6 "paymentPageUrl":"https://alfabank.ru/sme/payservice/sbp/",

7 "mediaType":"image/png",

8 "width":"600",

9 "height":"600",

10 "qrcId":"",

11 "queryData":

12 {

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

14 }

15 }

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 6/13

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

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

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

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

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

payload String (1…999) o Платёжная ссылка УПК. См. приложение 1

image String (an)

Длина зависит от формата, порядок 7000 символов

y Изображение QR-кода содержит энкодированный BASE64

mediaType String o Расширение QR-кода УПК, если ErrorCode = 0

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

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

status String (an‐20) o Статус регистрации Платёжной или Информационной ссы

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

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

• 200 OK

• 400 Bad Request

2.2 Запрос статуса оплаты по кассовому УПК

• Статус оплаты кассового универсального многоразового платёжного кода возможно проверить с помощью уже существующего м При этом, в ответе к уже существующим статусам, добавляется ещё два новых статуса для ЦР: «ENDD» и «ACDR».

• Также статус оплаты возможно проверить с помощью отдельного метода «GetCashUniQrStatus».

Метод GetCashUniQrStatus

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

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

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

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

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

{

"ErrorCode": "0",

"message": "OK",

"TermNo": "90080567",

"payload": "![CDATA[https://qr.nspk.ru/BS2R003FS8EFGAVM852PQS13N894HDLU?type=01&bank=620000000015&cr

"image": "iVBORw0KGgoAAAANSUhEUgAAAlg......",

"mediaType": "image/png",

"qrcId": "BS2R003FS8EFGAVM852PQS13N894HDLU",

"status": "CREATED"

}

{

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

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

}

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 7/13

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

payrrn String (n‐12) o Референсный номер платежа

uniQrId String (an‐32) y Идентификатор Кассового УПК

paramsId String (an‐32) y Идентификатор параметров Кассового У

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

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

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

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

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

messageID String (ans‐1024) o Уникальный идентификатор сообщения, GUID — если ErrorCode = 0

uniQrId String (an‐32) o Идентификатор Кассового УПК

payrrn String (n‐12) o Референсный номер платежа

trxId String (an‐32) o Уникальный идентификатор платежа в НСПК. Идентификатор Операции СБП будет заполнен то

• paymentServiceId = «PS0000000001»

• status = «ACWP» или «RJCT»

trxDT String (n‐14) o Дата и время платежа в AnyWay (ГГГГММДДччммсс)

paymentServiceId String (12) o Идентификатор Платёжного сервиса, с использованием которого был выполнен Перевод УПК

• «PS0000000001» — платёж через СБП

• «PS0000000002» — платёж с использованием ЦР

Будет отсутствовать в ответе при значении параметра status = «NTST» и будет заполнен при лю

BatchId String (n‐1…8) o Уникальный идентификатор смены (если смена терминала была открыта), метод получения см. ан

CreditDatePos String (ans 1‐256) o Дата операции, установленная Банком Получателя в ходе обработки уведомления НСПК (определ

merchantId String (an‐20) o Id магазина в НСПК

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

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

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

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

cashRegisterQrcStatus String y Текущий статус Кассовой ссылки СБП для указанного paramsId:

• «WAITING_PAYMENT» — Кассовая ссылка СБП для указанного paramsId активирована и готов

{

"command": "GetCashUniQrStatus",

"TermNo": "90080567",

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

"payrrn": "000000000256",

"uniQrId": "AS1R0006QD93NUCF9MIPLLLDD7BF49CI",

"paramsId": "BP10001NAJ5S985L9DM9GO6PK4H6KN3M"

}

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 8/13

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

• «IN_PROGRESS» — Операция по Кассовой ссылке СБП для указанного paramsId в процессе вы

• «DEACTIVATED» — Кассовая ссылка СБП с указанным paramsId более не существует (все дейс

paramsId String‐32 y Идентификатор активного набора параметров

kzo String (1…128) o Контрольное значение Операции СБП будет заполнено только при соблюдении следующих ус

• paymentServiceId = PS0000000001»

• status = «ACWP»

status String (4) o Статус Перевода УПК. Допустимые значения:

«NTST» — Перевод УПК не начат
«RCVD» — Перевод УПК в процессе обработки
«ENDD» — Перевод УПК завершён (только для оплаты ЦР)
«ACWP» — Перевод УПК выполнен успешно (только для оплаты через СБП)
«RJCT» — Перевод УПК отклонён (только для оплаты через СБП)
«ACDR» — Перевод в ЦР выполнен успешно (аналог «ACWP»), если указан в настройке ACW

timestamp UTC time format o Дата и время выполнения Операции СБП. Параметр будет заполнен только при соблюдении следу

• paymentServiceId = «PS0000000001»

• status = «ACWP» или «RJCT»

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

• «status» = «NTST», «RCVD» или «ACTC» — означает необходимость повтора запроса до получения одного из финальных статусов

• Получение «status» = «RJCT» означает отказ в оплате данного QR-кода

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

• 200 OK

• 400 Bad Request

1 {

2 "ErrorCode": "0",

3 "message": "Запрос выполнен",

4 "TermNo": "90080567",

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

6 "uniQrId": "AS1R0006QD93NUCF9MIPLLLDD7BF49CI",

7 "paramsId": "BP10001NAJ5S985L9DM9GO6PK4H6KN3M",

8 "trxStatus": "ACWP",

9 "payrrn": "000000000256",

10 "timestamp": "2025-06-24T11:53:09.000Z",

11 "cashRegisterQrcStatus": "DEACTIVATED",

12 "trxId": "B5175115309809010000120011530503",

13 "trxDT": "20250624115309",

14 "amount": "100",

15 "currency": "RUB",

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

17 "CreditDatePos": "20250624",

18 "payerId": "*********5744",

19 "kzo": "45dfe048b805b1f7612a51b961ee61e5df008314a1a3c82892a085cacff18500e8c7f09170c10415fd26710a4a

20 "merchantId": "MA0000018412",

21 "paymentServiceId": "PS0000000001"

22 }

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 9/13

2.3. Изменение параметров кассового УПК (универсального многоразового платёжного кода)

Запрос «ChangeAccForCashUniQr» направляется ТСП в Банк для выполнения запроса УПК API «Изменение параметров Многоразово отдельных параметров Многоразового или Кассового УПК, заданных при регистрации УПК.

Для Многоразового или Кассового УПК могут быть изменены:

• Уникальный идентификатор терминала (параметр TermNo)

• Получатель денежных средств в Переводе УПК или ТСП получателя (параметр merchantId). Новое значение merchantId может прин принадлежало прежнее значение merchantId, так и другому ЮЛ, ИП или Самозанятому, зарегистрированному в НСПК

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

• Набор Платёжных сервисов, с использованием которых может быть выполнен Перевод УПК по данному Многоразовому/Кассовом в Переводе УПК, выполненном с использованием того или иного Платёжного сервиса, например, Счет ТСП в Банке ТСП, на которы выполнения Операции СБП C2B (параметры Account и AccountDR)

Метод ChangeAccForCashUniQr

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

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

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

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

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

qrcId String (32) o Идентификатор Кассового УПК

account String (an‐20) o Новый счёт ЮЛ для УПК:

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

accountDR String (55) o Новый счёт ЮЛ для ЦР:

если заполнено — будет изменён счёт для оплаты ЦР в УПК

если не заполнено — значение берётся из поля AccountDR справочника терминалов

NewTermNo String (an‐20) o Новый уникальный идентификатор терминала. Поле обязательно, если НЕ переданы account, accountDR, NewMerchantId, redirectUrl

NewMerchantId String (an‐12) o Новый Id мерчанта (магазина) в НСПК.

Поле обязательно, если НЕ переданы account, accountDR, NewTermNo, redirectUrl

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

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

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

paymentPageUrl String (ans‐1024) o Ссылка для перенаправления Покупателя на Платёжную страницу Участника Сервиса УПК

fraudScore String o Индикатор Подозрительной Операции Банка ТСП

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

{

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

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

}

1 {

2 "command": "ChangeAccForCashUniQr",

3 "TermNo": "90080567",

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 10/13

https://wiki.finstream.ru/pages/viewpage.action?pageId=79692419#id-%D0%A8%D0%BB%D1%8E%D0%B7FastPayAgent%D0%B4%D0%BB%D1%8F%D0%B7%D0%B0%D1%8F%D0%B2%D0%BE%D0%BA%D0%A2%D0%A1%D0%9F-%D0%A2%D0%B5%D1%80%D0%BC%D0%B8%D0%BD%D0%B0%D0%BB%D1%8B https://wiki.finstream.ru/pages/viewpage.action?pageId=79692419#id-%D0%A8%D0%BB%D1%8E%D0%B7FastPayAgent%D0%B4%D0%BB%D1%8F%D0%B7%D0%B0%D1%8F%D0%B2%D0%BE%D0%BA%D0%A2%D0%A1%D0%9F-%D0%A2%D0%B5%D1%80%D0%BC%D0%B8%D0%BD%D0%B0%D0%BB%D1%8B

Правила заполнения и интерпретации параметров:

• В запросе должен быть заполнен хотя бы один из параметров: account, accountDR, NewTermNo, NewMerchantId, redirectUrl. Если ни ErrorCode = «90» и message = «Не указан ни один из обязательных параметров»

• account — будет выполнено изменение счёта ЮЛ, ИП или самозанятого для расчётов через СБП зарегистрированного УПК. Если зн из справочника терминалов

• accountDR — будет выполнено изменение/добавление счета ЮЛ, ИП или самозанятого для расчётов ЦР зарегистрированного УПК. берётся из справочника терминалов/ЮЛ

• Если параметр accountDR был передан в запросе, но длина его значения отличается от 55 — будет возвращена ошибка c ErrorCode Параметр accountDR должен содержать 55 символов»

• NewTermNo — будет выполнено изменение номера терминала для зарегистрированной Кассовой ссылки СБП. Новый номер терми или ТСТ указанного NewMerchantId запроса

• NewMerchantId — будет выполнено изменение ТСТ для зарегистрированной Кассовой ссылки СБП. Если поле NewTermNo в запросе перепривязка существующего TermNo к новому NewMerchantId

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

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

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

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

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

messageID String (ans‐1024) o Уникальный идентификатор сообщения, GUID — если ErrorCode = 0

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

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

account String (an‐20) y/o Cчёт для оплаты через СБП. В ответе должен присутствовать один из параметров account или accountDR, либо о

accountDR String (55) y/o Cчёт для оплаты ЦР.

В ответе должен присутствовать один из параметров account или accountDR, либо о

merchantId String (an‐12) y Id мерчанта (магазина) в НСПК

status String (an‐20) o Статус регистрации Платёжной или Информационной ссылки СБП («CREATED» —

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

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

• 200 ОК

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

5 "qrcId": "BS200031LP9DVTOR80O83FQ2ILIADFLM",

6 "account": "40201810100000088000",

7 "accountDR": "g.ab.cbrdc.wlt.clt.abcd0123-ab12-4a12-89ab-abcdef01234G",

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

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

10 "fraudScore": "0000000000000000",

11 "NewTermNo": "10000234",

12 "NewMerchantId": "MA0000020651"

13 }

1 {

2 "ErrorCode": "0",

3 "message": "OK",

4 "TermNo": "10000234",

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

6 "qrcId": "BS200031LP9DVTOR80O83FQ2ILIADFLM",

7 "account": "40201810100000088000",

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 11/13

• 400 Bad Request

Нотификация Клиента-получателя об исполнении перевода ЦР С2B

Сообщение отправляется из ПШ Банка на сервер ТСП и содержит Извещение Клиента-получателя об исполнении перевода ЦР (С2B)

Метод paymentDR/notification

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

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

command String (an‐1…50) o Константа «paymentDR/notification»

uniQrId String (an‐32) o Идентификатор платежа в системе ЮЛ‐получателя

operationId String o Идентификатор операции на ПлЦР (значение из тега ЭС <MsgHdr/OprId>)

status String (an‐20) o Статус платежа на ПлЦР

• если заполнено значение настройки ACWPstatusDR, то передаётся значение, указанное

• «RCVD» — Перевод УПК в процессе обработки

amount String (an‐1…12) o Сумма платежа в рублях с копейками

timestamp YYYY-MM-DDThh:mm:ss[.SSS] o Дата и время исполнения распоряжения на ПлЦР

payrrn String (n‐12) y Референсный номер платежа

BatchId String (n‐4…8) y Уникальный идентификатор смены (если смена терминала открыта)

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

CreditDatePos String (ans 1‐256) y Дата операции, установленная Банком Получателя в ходе обработки уведомления НСПК (опре

merchantName ? y Наименование ТСП

purpose String (ans‐210 y Назначение платежа

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

8 "accountDR": "g.ab.cbrdc.wlt.clt.abcd0123-ab12-4a12-89ab-abcdef01234G",

9 "status": "UPDATED",

10 "merchantId": "MA0000020651"

11 }

{

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

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

}

1 {

2 "command": "paymentDR/notification",

3 "uniQrId": "AD2000670LSS7DN18SJQDNP4B05KLJL1",

4 "operationId": "546464AX45546",

5 "status": "ACWP",

6 "amount": "10241.21",

7 "timestamp": "2024-08-01T10:15:00.000Z",

8 "payrrn": "102345678912",

9 "BatchId": "998844",

10 "TermNo": "90080567",

11 "CreditDatePos": "20240802",

12 "merchantName": "Рога и Копыта",

12/23/25, 11:24 AM Цифровой рубль

https://alfabank.ru/sme/payservice/sbp/docs/digital-rub/?rp-menuOpen=1 12/13

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

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

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

13 "purpose": "Кофе и булочка"

14 }

12/23/25, 11:24 AM Цифровой рубль

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

44 KiB Raw Blame History Unescape Escape

44 KiB

Raw Blame History