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

Обновлено 11 июля 2024

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

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

Параметры jsonParams:

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

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

{
    "userName": "testUserName",
    "password": "testPassword",
    "orderNumber": "e2574f1785324f1592d9029cb05adbbd",
    "amount": 19900,
    "returnUrl": "https://testmerchant.ru/return",
    "jsonParams": {
        "app2app": true,
        "app.deepLink": "android-app://ru.testbankmobile/main",
        "app.osType": "ios"
    }
}

Пример запроса в curl

curl --location --request POST 'https://ecomtest.sberbank.ru/ecomm/gw/partner/api/v1/register.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userName": "sbertest_0244",
    "password": "sbertest_024412345",
    "orderNumber": "AL1223201123223",
    "amount": 100,
    "currency": "643",
    "returnUrl": "https://ya.ru",
    "failUrl": "http://example.com/fail",
    "description": "регистрация заказа с максимальным набором полей",
    "language": "ru",
    "pageView": "DESKTOP",
    "clientId": "1080735968",
    "merchantLogin": "sbertest_0244",
    "jsonParams": {
        "osType": "ios",
        "app.deepLink": "yoomoney://checkout-info/v3",
        "app2app": "true",
        "web2app": "false"
    },
    "sessionTimeoutSecs": 6000,
    "features": "FORCE_SSL",
    "expirationDate": "2023-12-16T23:59:59",
    "phone": "79959977757",
    "email": "test@example.com"
}

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

Параметры externalParams.

Название	Тип	Обязательно	Описание
sbolDeepLink	ANS..1024	Да	Ссылка на приложение Банка для завершения оплаты. При внедрении SDK не используется.
sbolBankInvoiceId	ANS..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://ecomift.sberbank.ru/ecomm/gw/partner/api/v1/register.do

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