Создание рублевого платежного поручения
Запрос на создание рублевого платежного поручения (РПП).
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка. В случае использования подписи КЭП ЮЛ, необходимо передавать access_token пользователя, на имя которого выпущен сертификат КЭП ЮЛ.
Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU.
- Если в запросе на создание платежного документа передать ЭП к документу (объект digestSignatures), то Банк сразу начнет обработку документа.
- Если в запросе не передавать ЭП к документу, то платежное поручение будет создано в статусе черновик. Для начала обработки документа Банком потребуется зайти в интерфейс СберБизнес и подписать его.
Дайджест это текстовый документ, содержащий перечень и значения полей запроса, к которому он относится и предназначенный для подписания ЭП. Сохраняйте порядок и количество полей дайджеста, как показано в примере ниже, иначе подписать его не получится.
| Наименование поля | Описание поля | Пример |
|---|---|---|
| amount | Сумма платежа | 100.00 |
| date | Дата составления документа | 2018-05-31 |
| departmentalInfo.docNumber108 | Номер налогового документа(реквизит-108) | 123 |
| departmentalInfo.drawerStatus101 | Показатель статуса налогоплательщика(реквизит-101) | 01 |
| departmentalInfo.kbk | Код бюджетной классификации(реквизит-104) | 18210102010011000110 |
| departmentalInfo.oktmo | Код ОКТМО(реквизит-105) | 1701000 |
| departmentalInfo.paymentKind110 | Тип налогового платежа(реквизит-110) | НС |
| departmentalInfo.reasonCode106 | Показатель основания платежа(реквизит-106) | ТП |
| departmentalInfo.uip | Уникальный идентификатор платежа | 0 |
| externalId | Идентификатор документа, присвоенный сервисом | a0000000-0000-0000-0000-000000000001 |
| incomeTypeCode | Код вида дохода получателей выплаты по 229-ФЗ | 2 |
| operationCode | Код операции | 01 |
| payeeAccount | Номер счета получателя | 40702810600100001212 |
| payeeBankBic | БИК получателя | 044525225 |
| payeeBankCorrAccount | Корсчет банка получателя | 30101810400000000225 |
| payeeInn | Инн получателя | 222201236445 |
| payeeKpp | Кпп получателя | 222201001 |
| payeeName | Полное наименование получателя платежа | Общество с ограниченной ответственностью "Получатель" |
| payerAccount | Счет плательщика | 40702810500006103990 |
| payerBankBic | БИК плательщика | 044525225 |
| payerBankCorrAccount | Корсчет банка плательщика | 30101810400000000225 |
| payerInn | ИНН плательщика | 222201236445 |
| payerKpp | КПП плательщика | 222201001 |
| payerName | Полное наименование плательщика | Общество с ограниченной ответственностью "Клиент" |
| priority | Очередность платежа | 5 |
| purpose | Назначение платежа | Оплата интернет заказа №123. НДС нет. |
| voCode | Код вида валютной операции | 61150 |
| creditContractNumber | Номер кредитного договора | 2026/33556 |
Пример:
amount=100.00
date=2018-05-31
departmentalInfo.docNumber108=123
departmentalInfo.drawerStatus101=01
departmentalInfo.kbk=18210102010011000110
departmentalInfo.oktmo=01701000
departmentalInfo.paymentKind110=НС
departmentalInfo.reasonCode106=ТП
departmentalInfo.uip=0
externalId=a0000000-0000-0000-0000-000000000001
incomeTypeCode=2
operationCode=01
payeeAccount=40702810600100001212
payeeBankBic=044525225
payeeBankCorrAccount=30101810400000000225
payeeInn=222201236445
payeeKpp=222201001
payeeName=Общество с ограниченной ответственностью "Получатель"
payerAccount=40702810500006103990
payerBankBic=044525225
payerBankCorrAccount=30101810400000000225
payerInn=222201236445
payerKpp=222201001
payerName=Общество с ограниченной ответственностью "Клиент"
priority=5
purpose=Оплата интернет заказа №123. НДС нет.
voCode=61150
creditContractNumber=2026/33556
При тестировании создания рублевого платежного поручения в Песочнице соблюдайте правила:
- Генерируйте уникальный
externalIdдля каждого документа. - Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (certificateUuid).
- Все остальные поля запроса заполняйте произвольными данными (реквизиты, суммы, назначение платежа) в соответствии с требованиями в документации.
Сценарии тестирования
Для тестирования сценариев используйте фиксированные значения certificateUuid. При использовании любых других значений certificateUuid вернется ошибка WORKFLOW_FAULT "Проверьте актуальность сертификата электронной подписи."
1. Чтобы создать неподписанное платежное поручение (черновик), отправьте запрос без объекта digestSignatures.
Статус в ответе: bankStatus: "CREATED"
2. Для отправки документа с единственной подписью передайте в объекте digestSignatures тестовый UUID единоличного исполнительного органа (ЕИО).
Параметры:
certificateUuid:bb014b5d-8159-40be-97c1-eafeed4a8c3d
Статус в ответе: bankStatus: "IMPLEMENTED"
Пример:
"digestSignatures": [
\{
"certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c3d",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\}
],
3. Для отправки документа с двумя подписями передайте в объекте digestSignatures тестовые UUID первой И второй подписи.
Параметры:
certificateUuid:d5d4f811-f4d4-4205-a70f-58f772eeab72(Первая подпись)certificateUuid:4f29c8ef-b55d-43c7-a321-f2b1303a29cd(Вторая подпись)
Статус в ответе: bankStatus: "IMPLEMENTED"
Пример:
"digestSignatures": [
\{
"certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\},
\{
"certificateUuid": "4f29c8ef-b55d-43c7-a321-f2b1303a29cd",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\}
],
4. Для отправки документа с одной из двух подписей передайте в объекте digestSignatures тестовые UUID первой ИЛИ второй подписи.
Статус в ответе: bankStatus: "PARTSIGNED"
Параметры:
certificateUuid:d5d4f811-f4d4-4205-a70f-58f772eeab72(Первая подпись)certificateUuid:4f29c8ef-b55d-43c7-a321-f2b1303a29cd(Вторая подпись)
Пример:
"digestSignatures": [
\{
"certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
"base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
\}
],
Запрос
Ответы
Успешный запрос перевода
"Ошибка в запросе"
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request запроса. Скорректируйте заполнение атрибутов и повторите запрос. |
| VALIDATION_FAULT | Ошибка валидации | Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request запроса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
| WORKFLOW_FAULT | Ошибка бизнес-процесса | Данные не соответствуют логике бизнес- процесса. Сведение об ошибке содержится в message (например, отсутствие требуемых объектов (организаций, счетов, реквизитов банков), невозможность их идентификации, дублирование уникальных идентификаторов. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
"Не авторизован"
| Cause | Message | Description |
|---|---|---|
| UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
"Операция не может быть выполнена: доступ к ресурсу запрещен"
| Cause | Message | Description |
|---|---|---|
| ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция PAY_DOC_RU. Необходимо добавить одному или несколько операций в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
"Превышен лимит запросов"
| Cause | Message | Description |
|---|---|---|
| TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
"Внутренняя ошибка сервера"
| Cause | Message | Description |
|---|---|---|
| UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
"Сервис временно недоступен"
| Cause | Message | Description |
|---|---|---|
| UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |