> For the complete documentation index, see [llms.txt](https://docs.payanyway.ru/marketplace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payanyway.ru/marketplace/sbp/opisanie-polei-dlya-perevodov-sbp.md).

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

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

* **SECUREDFIELD:idBp\_24:** список уникальных идентификатор банков-участников переводов СБП. Только для протокола C2C Push: если клиент-Получатель установил «банк по умолчанию», в ответе такой банк будет с пометкой «по умолчанию»**.**
* **SECUREDFIELD:scenarios:** сценарий протокола СБП, по которому проводится операция. В ответе возвращается список банков-участников, которые поддерживают данный сценарий. Если в запросе нет этого параметра, то возвращается список банков-участников для сценария C2CPush. Возможные значения параметра: C2CPush, Me2MePush, C2BQRD, C2BQRS, C2BMcom, C2BRfnd, B2COther, Me2MePull. Описание сценариев можно найти в разделе [«Система быстрых платежей»](/marketplace/sbp/sistema-bystrykh-platezhei.md).

**C2C/B2C:**

* **SECUREDFIELD:payment\_stage:** поле означает шаг выполнения оплаты и должно быть в каждом запросе GetNextStep.SECUREDFIELD:payment\_stage в ответах на запросы указывает следующий шаг.
* **SECUREDFIELD:minTime и SECUREDFIELD:expirationTime:** поля показывают минимальное и максимальное время отправки следующего запроса, должны быть в каждом ответе на запрос GetNextStep. Если время следующего запроса выйдет из указанного интервала, вернется соответствующая ошибка.
* **SECUREDFIELD:sourceAmount**: сумма, которая списывается со счёта плательщика. 
* **SECUREDFIELD:SOURCETARIFFMULTIPLIER**: управляемый размер комиссии; значение размера комиссии, которым может управлять инициатор отправляемого запроса на перевод.
* **providerId**: идентификатор провайдера в Cистеме МОНЕТА.РУ.
* **CUSTOMFIELD:idPo\_20:** номер мобильного телефона получателя платежа.\
  **Формат поля для сценария** [**B2C «Прочие выплаты физическому лицу»**](/marketplace/sbp/vyplaty-fizicheskomu-licu.md): в этом сценарии используются только российские номера мобильных телефонов. Номер мобильного телефона длиной от 11 до 12 символов; код страны может указываться как +7, 7, 8. Пример: +7 911 111 11 11; 7 911 111 11 11; 8 911 111 11 11.\
  \
  **Формат поля для сценария** [**c2cpush/me2mepush**](/marketplace/sbp/popolnenie-koshelka-po-nomeru-telefona.md) **и** [**me2mepull**](/marketplace/sbp/protokol-s2s.-scenarii-me2me-pull.md): в указанных сценариях могут использоваться российские и нероссийские номера мобильных телефонов.\
  **Для российских номеров телефонов**: номер мобильного телефона длиной от 11 до 12 символов; код страны может указываться как +7, 7, 8. \
  Пример: +7 911 111 11 11; 7 911 111 11 11; 8 911 111 11 11. \
  **Для нероссийских номеров телефонов**: номер мобильного телефона начинается с префикса «+» и имеет длину от 11 до 16 символов. \
  Примеры нероссийских номеров телефонов: +37410111111 (Армения), +998111111111 (Узбекистан).<br>
* **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](https://qr.nspk.ru/AS10003P3RH0LJ2A9ROO038L6NT5RU1M?type=02\&bank=100000000112\&sum=1021\&cur=RUB\&crc=F3D0)&#x20;
* **Externaltransaction:** идентификатор динамического QR-кода.
* **SECUREDFIELD:qr:** в этом поле передается QR-payload.&#x20;
* **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.