ym88659208ym87991671
Для платежного шлюза с эндпоитом ecommerce.sberbank.ru | Документация для разработчиков

Для платежного шлюза с эндпоитом ecommerce.sberbank.ru

Обновлено 19 декабря 2023

В сценариях автоматической и ручной оплаты с SDK необходимо передавать значение атрибута sbolBankInvoiceId – это уникальный идентификатор заказа, сгенерированный Банком. Его значение можно получить в ответе на запрос создания заказа (register.do или registerPreAuth.do) в Платежном Шлюзе Сбербанка и только при условии, что вы корректно указали дополнительные параметры в теле своего запроса.

Вне зависимости от того, используете ли вы одностадийные (register.do) или двухстадийные запросы (registerPreAuth.do), необходимо добавить дополнительные параметры в теле запроса в структуру jsonParams:

Параметры jsonParams:

НазваниеТипОбязательноОписание
app2appБулевое значениеДаВозможны следующие значения: true, false. Для работы с SDK необходимо передавать значение true. Для использования этого параметра должна быть включена пермиссия.
app.osTypeANS..32ДаТип ОС. Возможные значения: ios, android
app.deepLinkANS..255ДаСсылка на приложение мерчанта. Не влияет на использование SDK. Рекомендуется указывать схему своего приложения.

Пример запроса:

{
"errorCode": "0",
"errorMessage": "Обработка запроса прошла без системных ошибок",
"orderId": "a67b0ced-c9a4-4cfb-bce3-b9595afaafc1",
"formUrl": "https://ecomtest.sberbank.ru/pp/pay_ru?orderId=a67b0ced-c9a4-4cfb-bce3-b9595afaafc1",
"externalParams": {
"sbolDeepLink": "sberpay://invoicing/v2?bankInvoiceId=a67b0cedc9a44cfbbce3b9595afaafc1&operationType=Web2App&option=Connect",
"sbolBankInvoiceId": "a67b0cedc9a44cfbbce3b9595afaafc1"
}
}

При корректном вызове создания заказа ожидается, что в ответе будет получено необходимо значение sbolBankInvoiceId в структуре externalParams.

Параметры externalParams.

НазваниеТипОбязательноОписание
sbolDeepLinkANS..1024ДаСсылка на приложение Банка для завершения оплаты. При внедрении SDK не используется.
sbolBankInvoiceIdANS..1024ДаУникальный идентификатор заказа, сгенерированный Банком. Это значение необходимо передавать при обращении к SDK.

Пример ответа:

{
"errorCode": "0",
"errorMessage": "Обработка запроса прошла без системных ошибок",
"orderId": "a67b0ced-c9a4-4cfb-bce3-b9595afaafc1",
"formUrl": "https://ecomtest.sberbank.ru/pp/pay_ru?orderId=a67b0ced-c9a4-4cfb-bce3-b9595afaafc1",
"externalParams": {
"sbolDeepLink": "sberpay://invoicing/v2?bankInvoiceId=a67b0cedc9a44cfbbce3b9595afaafc1&operationType=Web2App&option=Connect",
"sbolBankInvoiceId": "a67b0cedc9a44cfbbce3b9595afaafc1"
}
}

По всем возникшим вопросам по регистрации обращайтесь на почтовый адрес: support@ecom.sberbank.ru

Регистрация заказов в платежном шлюзе Сбера в песочнице

В сценариях автоматической и ручной оплаты с SDK необходимо передавать значение атрибута sbolBankInvoiceId – это уникальный идентификатор заказа, сгенерированный Банком. Его значение можно получить в ответе на запрос создания заказа (register.do или registerPreAuth.do) в Платежном Шлюзе Сбербанка и только при условии, что вы корректно указали дополнительные параметры в теле своего запроса.

Для регистрации заказа в песочнице использовать: https://ecomtest.sberbank.ru/ecomm/gw/partner/api/v1/register.do

Общая документация по работе со шлюзом находится по адресу: https://ecomtest.sberbank.ru/doc#tag/basicServices/operation/register

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.