Исполнение перевода B2C
Запрос принимает и исполняет перевод B2C
В параметре scope ссылки авторизации пользователя вашей компании должен быть указан сервис BC_SBP_PAYMENT для получения доступа к этому ресурсу.
При получении ошибки:
{
"internalErrorCode": "234.1-1013",
"cause": "ACTION_ACCESS_EXCEPTION",
"referenceId": "33b65e55-5624-4f97-adbe-3dffb505b41f",
"message": "Недостаточно прав для вызова POST /sbpb2c/v1/sbp/paymentB2C/execute. Отсутствует доступ хотя бы до одного из сервисов [BC_SBP_PAYMENT]."
}
Говорит об отсутствии в scope операции BC_SBP_PAYMENT. Для добавления необходимо написать письмо на почту поддержки supportdbo2@sberbank.ru.
Для отправки платежа необходимо создать запрос и дайджест на его основе.
Что такое дайджест?
Дайджест (подписываемый образ) - некоторый блок данных (строка или файл), сформированный на основе данных документа. "Слепок" документа на момент подписания. Непосредственно для него будет осуществляться операция формирования подписи. Должен содержать юридически значимые данные документа, по которым в дальнейшем может быть реализован процесс разбора спорных ситуаций с клиентами. Дайджест должен формироваться на основании актуальных данных документа непосредственно перед подписанием/проверкой подписи.
Пример дайджеста:
id=123e4567-e89b-12d3-a456-426655440000
payerAccount=40702810111111110000
receiverPhone=79268889767
bankName=Альфа-банк
bankAgentId=100000000008
kvd=1
payeeName=Иванов Иван Иванович
comment=Прочий перевод
paymentPurpose=За товар по договору №2 от 12/01/2023
amount=100022
Важно:
Формирование дайджеста должно включать в себя только присутствующие поля и значения, сохраняя их исходные типы данных и точный порядок из примера ниже. Любые отклонения приведут к ошибке подписи. Конкретные примеры:
-
Если в запросе amount=10, в дайджесте должно быть amount=10.
-
Если какое-то поле, например comment отсутствует в запросе, то и в дайджест его включать не нужно
| Статус | Описание |
|---|---|
| ACCEPTED | Платеж принят в обработку |
| IMPLEMENTED | Платеж исполнен |
| CANCELLED | Платеж отменен |
| REFUSEDBYBANK | Отказ со стороны банка отправителя платежа |
| REFUSEDBYFTS | Отказ зачисления со стороны банка получателя |
| FRAUDDENY | Отказ со стороны Антифрод-проверок |
| HTTP код | internalErrorCode | cause | Эндпоинт | В ответе метода в message |
|---|---|---|---|---|
| 200 | - | - | POST /v1/sbp/paymentB2C/execute | - |
| 400 | 786-0001 | VALIDATE_ERROR | POST /v1/sbp/paymentB2C/execute POST /v1/sbp/paymentB2C/getStatus | Ошибка валидации запроса. |
| 400 | 786-0002 | PAYEE_BANK_NOT_FOUND | POST /v1/sbp/paymentB2C/execute | Банк получателя не найден. Укажите корректное название банка получателя. |
| 400 | 786-0003 | DUPLICATE_ERROR | POST /v1/sbp/paymentB2C/execute | Запрос с таким ID уже существует. |
| 200 | 786-0214 | FRAUD_DENY | POST /v1/sbp/paymentB2C/execute | Ваш перевод признан высокорискованным и был отклонен. Для выяснения причин свяжитесь с банком по телефону, указанному в договоре. |
| 200 | 786-0217 | DO_DENY_RESTRICTION | POST /v1/sbp/paymentB2C/execute | Осуществление перевода в настоящее время недоступно из-за ограничения на счете. |
| 200 | 786-0218 | DO_DENY_NOT_ENOUGH_MONEY | POST /v1/sbp/paymentB2C/execute | На счете недостаточно средств для осуществления перевода и оплаты комиссии. Пополните счет или уменьшите сумму перевода. |
| 200 | 786-0223 | DIGITALDBO_SERT_ERROR | POST /v1/sbp/paymentB2C/execute | Не удалось выполнить перевод. Попробуйте перевести деньги другим способом. |
| 200 | 786-0224 | DIGITALDBO_SIGN_ERROR | POST /v1/sbp/paymentB2C/execute | Не удалось выполнить перевод. Попробуйте перевести деньги другим способом. |
| 200 | 786-0225 | PERMISSION_ERROR | POST /v1/sbp/paymentB2C/execute POST /v1/sbp/paymentB2C/getStatus | Не удалось выполнить перевод. Попробуйте перевести деньги другим способом. |
| 200 | 786-0226 | SIGNCONFIRM_ERROR | POST /v1/sbp/paymentB2C/execute | Не удалось выполнить перевод. Попробуйте перевести деньги другим способом. |
| 200 | 786-0229 | PAYMENT_NOT_FOUND | POST /v1/sbp/paymentB2C/getStatus | Платеж не найден. |
| 200 | 786-0230 | CLIENT_NOT_FOUND | POST /v1/sbp/paymentB2C/execute | Клиент не зарегистрирован в СБП. |
| 200 | 786-0231 | MP_DENY | POST /v1/sbp/paymentB2C/execute | 1. Превышена допустимая сумма платежа. 2. При выполнении операции произошла ошибка. Мы уже работаем над ее устранением. Повторите попытку позже. 3. Проведение операции запрещено на основании п. 5 ст. 7.7. Федерального закона № 115-ФЗ. 4. Проведение операции запрещено. |
| 200 | 786-0232 | SIGN_DEFINITION_ERROR | POST /v1/sbp/paymentB2C/execute | Не удалось выполнить перевод. Попробуйте перевести деньги другим способом. |
| 200 | 786-0235 | MRK_ERROR | POST /v1/sbp/paymentB2C/execute | Не удалось рассчитать комиссию за перевод. Повторите попытку позже. |
| 200 | 786-0211 | NSPK_DENY | POST /v1/sbp/paymentB2C/execute | Поле зарезервировано и будет использоваться с 01.04.2026 |
| 200 | 786-0244 | PAYMENT_B2C_CANCELLED | POST /v1/sbp/paymentB2C/execute POST /v1/sbp/paymentB2C/getStatus | Платеж отклонен банком. Попробуйте повторить платеж еще раз. |
| 200 | 786-0250 | INCORRECT_PAYEENAME_REQUEST_VALUE | POST /v1/sbp/paymentB2C/execute | Переданное значение «Ф. И. О. получателя денежных средств» не совпадает с Ф. И. О. владельца счета. |
| 503 | 786-0220 | SERVICE_IS_NOT_AVAILABLE | POST /v1/sbp/paymentB2C/execute POST /v1/sbp/paymentB2C/getStatus | В настоящее время сервис недоступен по техническим причинам. Попробуйте позднее. |
| 500 | 786-0500 | INTERNAL_SERVER_ERROR | POST /v1/sbp/paymentB2C/execute | При выполнении операции произошла ошибка. Мы уже работаем над ее устранением. Повторите попытку позже. |
Функционал позволяет получать предопределенные ответы при указании соответствующего значения в поле amount.
| № | amount | Описание | Ошибка |
|---|---|---|---|
| 1 | 4200 | Подпись не проверяем, но проходим по всем интеграциям | - |
| 2 | 4201 | Вернуть статус успешного платежа | - |
| 3 | 4203 | Сертификат не валидный или не найден | DIGITALDBO_SERT_ERROR |
| 4 | 4204 | Данные по подписи не найдены | DIGITALDBO_SIGN_ERROR |
| 5 | 4205 | Ошибка на этапе проверки подписи | SIGNCONFIRM_ERROR |
| 6 | 4206 | Внутренняя ошибка сервера | INTERNAL_SERVER_ERROR |
| 7 | 4208 | Банк не найден. Не удалось однознач но определить банк | PAYEE_BANK_NOT_FOUND |
| 8 | 4209 | Клиент не найден | CLIENT_NOT_FOUND |
| 9 | 4210 | Недостаточно прав/полномочий для осуществления операции | PERMISSION_ERROR |
| 10 | 4211 | Отказ по результату проверок Антифрод | FRAUD_DENY |
| 11 | 4212 | Отказ со стороны банка получателя | PAYMENT_B2C_CANCELLED |
| 12 | 4213 | Недостаточно денежных средств для проведения операции | DO_DENY_NOT_ENOUGH_MONEY |
| 13 | 4214 | Отказ по результатам внутрибанковских проверок | MP_DENY |
| 14 | 4215 | Отказ. На счете имеется ограничение | DO_DENY_RESTRICTION |
| 16 | 4218 | ФИО получателя не соответствует указанному в запросе | INCORRECT_PAYEENAME_REQUEST_VALUE |