Описание полей для переводов СБП
Получение списка банков-участников:
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: номер счёта плательщика в Системе МОНЕТА.РУ, т.е. номер счёта, с которого выполняется перевод.
Payee: номер счёта получателя в Системе МОНЕТА.РУ.
Важно: SOAP и JSON поля, помеченные required="true", понадобятся для выполнения переводов СБП (C2C/B2C). Такие поля нужно передавать в запросах на перевод СБП (C2C/B2C) на следующем шаге выполнения оплаты.
C2B:
Qrlink: ссылка на графическое отображение QR.
Qrpayload или payload: payload QR-кода — это URL/платежная ссылка с параметрами. Если разместить его в мобильном приложении или мобильной версии сайта, то при нажатии откроется установленное на телефоне приложение банка-участника СБП C2B с возможностью оплаты. QR-payload — это строка вида с необходимой для платежа информацией: https://qr.nspk.ru/AS10003P3RH0LJ2A9ROO038L6NT5RU1Mtype=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.
Last updated