For Marketplace
Search…
⌃K

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

Получение списка банков-участников:
  • 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: сумма, которая списывается со счёта плательщика.
  • providerId: идентификатор провайдера в Cистеме МОНЕТА.РУ.
  • CUSTOMFIELD:idPo_20: номер мобильного телефона получателя платежа, до 12 символов; код стран может указываться, как +7, 7, 8.Пример: +7 911 111 11 11; 7 911 111 11 11; 8 911 111 11 11.
  • 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.