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

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

Обновлено 7 мая 2024

В сценариях автоматической и ручной оплаты с 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. Рекомендуется указывать схему своего приложения.

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

{
"userName": "testUserName",
"password": "testPassword",
"orderNumber": "e2574f1785324f1592d9029cb05adbbd",
"amount": 19900,
"returnUrl": "https://testmerchant.ru/return",
"jsonParams": {
"app2app": true,
"app.osType": "android",
"app.deepLink": "https://merchant.example.com/backUrl"
}
}

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

Параметры externalParams.

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

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

{
"orderId": "04f9d388-995c-745a-a849-45b85e22219c",
"formUrl": "https://sbergate.com/payment/merchants/sbersafe_sberid/
payment_ru.html?mdOrder=04f9d388-995c-745a-a849-45b85e22219c",
"externalParams": {
"sbolInactive": "false",
"sbolBankInvoiceId": "729a0130-968a-41dc-883e-6918c8cc06c1",
"sbolDeepLink": "sberpay://invoicing/v2?
bankInvoiceId=729a0130-968a-41dc-883e-6918c8cc06c1&operationType=App2App"
} }

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

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

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

Для регистрации заказа в песочнице использовать: https://3dsec.sberbank.ru/payment/rest/register.do

Общая документация по работе со шлюзом находится по адресу: https://securepayments.sberbank.ru/wiki/doku.php/main_page

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