Описание полей для переводов СБП

Получение списка банков-участников

SECUREDFIELD:idBp_24

Список уникальных идентификатор банков-участников переводов СБП. Только для протокола C2C Push: если клиент-Получатель установил «банк по умолчанию», в ответе такой банк будет с пометкой «по умолчанию».

SECUREDFIELD:scenarios

Сценарий протокола СБП, по которому проводится операция. В ответе возвращается список банков-участников, которые поддерживают данный сценарий. Если в запросе нет этого параметра, то возвращается список банков-участников для сценария C2CPush. Возможные значения параметра: C2CPush, Me2MePush, C2BQRD, C2BQRS, C2BMcom, C2BRfnd, B2COther, Me2MePull. Описание сценариев можно найти в разделе «Система быстрых платежей».

C2C/B2C

SECUREDFIELD:payment_stage

Поле означает шаг выполнения оплаты и должно быть в каждом запросе GetNextStep.SECUREDFIELD:payment_stage в ответах на запросы указывает следующий шаг.

SECUREDFIELD:minTime** и SECUREDFIELD:expirationTime

Поля показывают минимальное и максимальное время отправки следующего запроса, должны быть в каждом ответе на запрос GetNextStep. Если время следующего запроса выйдет из указанного интервала, вернется соответствующая ошибка.

SECUREDFIELD:sourceAmount

Сумма, которая списывается со счёта плательщика.

SECUREDFIELD:SOURCETARIFFMULTIPLIER

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

providerId

Идентификатор провайдера в Cистеме МОНЕТА.РУ.

CUSTOMFIELD:idPo_20

Номер мобильного телефона получателя платежа.

Формат поля для сценария B2C «Прочие выплаты физическому лицу»: в этом сценарии используются только российские номера мобильных телефонов. Номер мобильного телефона длиной от 11 до 12 символов; код страны может указываться как +7, 7, 8. Пример: +7 911 111 11 11; 7 911 111 11 11; 8 911 111 11 11.

Формат поля для сценария c2cpush/me2mepush и me2mepull: в указанных сценариях могут использоваться российские и нероссийские номера мобильных телефонов.

Для российских номеров телефонов: номер мобильного телефона длиной от 11 до 12 символов; код страны может указываться как +7, 7, 8.

Пример: +7 911 111 11 11; 7 911 111 11 11; 8 911 111 11 11.

Для нероссийских номеров телефонов: номер мобильного телефона начинается с префикса «+» и имеет длину от 11 до 16 символов.

Примеры нероссийских номеров телефонов: +37410111111 (Армения), +998111111111 (Узбекистан).

SECUREDFIELD:idBp_24

Список уникальных идентификатор банков-участников переводов СБП; если клиент-Получатель установил «банк по умолчанию», в ответе такой банк будет с пометкой «по умолчанию».

Банк по умолчанию

Это банк, на который по умолчанию зачислятся денежные средства при переводе СБП (C2C). Устанавливается в ДБО Банка Получателя клиентом-физическим лицом. Это необязательная опция, такой банк может быть не установлен. Содержится в составе поля CUSTOMFIELD:idBp_24_name.

CUSTOMFIELD:pamPo_74

PAM-фраза, т.е. ФИО получателя перевода. Данное поле помечено required=“false”, т.к. не используется в запросах на перевод СБП (C2C/B2C), но позволяет убедиться в правильности перевода.

CUSTOMFIELD:ioOpkcSbp_27

Идентификатор (номер) операции на стороне АО «НСПК».

SECUREDFIELD:sumOpSbp_44

Сумма, которая зачисляется на счет получателя.

SECUREDFIELD:nbsOt_30

8-значный номер счёта в Системе МОНЕТА.РУ, с которого нужно отправить перевод СБП.

SECUREDFIELD:unsBo_79

Уникальный идентификатор или номер сообщения, сгенерированный Банком Отправителем НКО «МОНЕТА» (ООО).

SECUREDFIELD:np_32

Назначение перевода; не обязательно для передачи в запросе. В случае присутствия должно соответствовать паттерну ^[A-zА-яЁё0-9\u0020-\u002f\u003a-\u0040\u005b-\u0060\u007b-\u007e\u2116]{1,140}$ (от 1 до 140 символов)

SECUREDFIELD:SBPBANKID

Id банка, из которого планируется перевести деньги в сценарии Me2Me Pull.

Payer

Номер счёта плательщика в системе Монета.ру, с которого выполняется перевод. Для СБП этот параметр всегда будет равен 364. Поле является обязательным.

Payee

Номер счёта получателя в Системе МОНЕТА.РУ.

C2B

Qrlink

Ссылка на графическое отображение QR.

Qrpayload или payload

Payload QR-кода — это URL/платежная ссылка с параметрами. Если разместить его в мобильном приложении или мобильной версии сайта, то при нажатии откроется установленное на телефоне приложение банка-участника СБП C2B с возможностью оплаты. QR-payload — это строка вида с необходимой для платежа информацией: https://qr.nspk.ru/AS10003P3RH0LJ2A9ROO038L6NT5RU1M?type=02&bank=100000000112&sum=1021&cur=RUB&crc=F3D0

Externaltransaction

Идентификатор динамического QR-кода.

SECUREDFIELD:qr

В этом поле передается QR-payload.

SECUREDFIELD:operationId2Refund

Операция возврата платежа по QR.

CUSTOMFIELD:QRTTL

Период в минутах, в течение которого будет возможна оплата по платёжной ссылке (QR-коду).

accountId

Идентификатор счета Получателя/ТСП в Системе МОНЕТА.РУ.

qrcId

Идентификатор QR-кода/Кассовой ссылки.

sbp

Варианты возможного действия с многоразовой ссылкой СБП (статического QR и Кассовой ссылки). Допустимые значения: cashLinkList - получение списка зарегистрированных Кассовых ссылок; cashLinkUpdate - редактирование описания Кассовой ссылки; cashLinkRegistration - регистрация Кассовой ссылки; staticQrRegistration - регистрация статического QR (QRS); qrInfo - получение информации по идентификатору многоразового QR (qrcId).

STATISQRCID

Уникальный идентификатор многоразовой ссылки или QR (Кассовая ссылка или статический QR).

imageLink

Ссылка на графическое представление QR-кода. Ширину и высоту изображения можно регулировать параметрами height и width в диапазоне от 100px до 1000px. Стандартная ширина и высота картинки QR-кода равна 300px.

clientId

Идентификатор/описание Кассовой ссылки, задается Получателем/ТСП. В пределах одного счета это значение уникально. Максимальное количество символов 140.

brandName

Торговое наименование Получателя/ТСП.

scenario

Тип сценария ссылки СБП. Допустимые значения: C2B – одноразовая или многоразовая платежная ссылка СБП с фиксированной суммой. C2B_CASH_REGISTER – Кассовая платежная ссылка СБП. C2B_OPEN_SUM – многоразовая платежная ссылка СБП с открытой суммой (статический QR).

type

Тип функциональной ссылки СБП. Допустимые значения: 01 - QR-Static (многоразовая платежная ссылка СБП). Может использоваться для выполнения множества Операций СБП C2B. 02 - QR-Dynamic (одноразовая платежная ссылка СБП). Предназначена для выполнения единичного перевода СБП C2B. 03 - QR-Subscription (информационная ссылка СБП для привязки счета Плательщика).

redirectUrl

Необязательный параметр, содержит ссылку для возврата Плательщика из приложения Банка Плательщика в приложение или на сайт Получателя/ТСП. При работе с динамическим QR или Кассовой ссылкой Плательщик перенаправляется в зависимости от статуса операции на SUCCESSURL, FAILURL, RETURNURL, INPROGRESSURL (если Получатель не использует собственные url, то применяются стандартные url в Системе МОНЕТА.РУ). При работе со статическим QR Плательщик перенаправляется на главную страницу сайта или приложения Получателя/ТСП, если redirectUrl не указан при запросе на регистрацию статического QR по API.