Для платежного шлюза с эндпоинтом 3dsec.sberbank.ru
В сценариях автоматической и ручной оплаты с 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.osType": "android",
"app.deepLink": "https://merchant.example.com/backUrl"
}
}
При корректном вызове создания заказа ожидается, что в ответе будет получено необходимо значение sbolBankInvoiceId в структуре externalParams.
Параметры externalParams.
| Название | Тип | Обязательно | Описание |
|---|---|---|---|
| sbolDeepLink | ANS..1024 | Да | Ссылка на приложение Банка для завершения оплаты. При внедрении SDK не используется. |
| sbolBankInvoiceId | ANS..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"
} }