Sberbank
Быстрый старт
- Подписаться at sberbank.ru и получить API полномочия
- Создать терминал в Консоль Admin с приведенными ниже параметрами
- Начало обработки — адаптер предварительно построен и готов к использованию
Обзор
Платежная интеграция Сбербанка
| поставщик ID | sber |
| Категория | Банковские переводы |
| Сайт | sberbank.ru |
Поддерживаемые операции: Payments Status Payouts
конфигурация
Необходимые параметры
| Параметр | Описание |
|---|---|
login | Продавец Логин для Sber API |
pass | Пароль аутентификации для Sber API |
Факультативные параметры
| Параметр | Описание |
|---|---|
channel | Канал подключения (необязательно) (по умолчанию): mychannel) |
bik | Банк BIC код (для карточных платежей) (по умолчанию): 044525225) |
account | Расчетный счет (для карточных платежей) (по умолчанию): 40702810...) |
fiscalization_mode | "внешний" |
fiscalization_config_id | FiscalizationConfig.id для ATOL/OrangeData (по умолчанию): 123) |
Пример конфигурации
{
"provider": "sber",
"provider_params": {
"login": "merchant-api",
"pass": "secure_password",
"returnUrl": "https://merchant.com/success",
"failUrl": "https://merchant.com/fail"
}
}
Платежный поток
Платежи - двухэтапный процесс
Шаг вперед 1Регистрация платежа (/register.do)
- Заказ создается в системе Сбербанка
- Возвращение
orderId(внешняя ось) - Для SBP: Возвращение
sbolDeepLinkдля оплаты - Для карт: OrderId сохраняется для следующего шага (идентификаторы:
orderId)
Шаг вперед 2Оплата заказа (/paymentOrder.do) - только карты
- Данные карты отправляются с заказомId (идентификаторы:
orderId) - Возвращение
formUrl3DS или ссылка подтверждения - Возвращение в
auth_paramsперенаправление для пользователя
Тип платежа Подробности
Карточные платежи (bank_card)
- Требуется два запроса: регистрационный + платежный (идентификаторы:
paymentOrder) formUrlиз платежного ордера используется для 3DS (идентификаторы:paymentOrder)- Данные карты передаются с префиксами
$PAN,$CVC
SBP Платежи (sbp)
- Только один запрос: зарегистрироваться SBP параметры
- Возвращение
sbolDeepLinkво внешних параметрах (идентификаторы:externalParams) - Пользователь переходит по ссылке для оплаты в банковском приложении
Проверка статуса
Конечная точка: /getOrderStatusExtended.do
Параметры:
orderIdПорядок ID (заказ поставщика) ID)userNameиpassword
Возвращение:
orderStatus- статус заказаactionCode- Код действий0 = успехactionCodeDescription- описание ошибки
Картирование состояния
| Статус поставщика | 4pay Статус | Описание |
|---|---|---|
0 | new | Заказ зарегистрирован, не оплачен |
1 | authorized | Предварительно утвержденная сумма |
2 | charged | Полностью уполномоченный |
3 | rejected | Разрешение отменено |
4 | refunded | Обработанный возврат |
5 | authorizing | ACS инициированное разрешение |
6 | rejected | Разрешение отклонено |
Испытание
Песочница URL
https://ecomtest.sberbank.ru/ecomm/gw/partner/api/v1
Тестовые карты
| Карта | Номер | экспедиция | CVV | Пароль 3DS | Результат |
|---|---|---|---|---|---|
| виза | PROVIDER_TEST_PAN | Любое будущее | любой 3 цифры | 12345678 | Успешный платеж |
| MasterCard | PROVIDER_TEST_PAN | Любое будущее | любой 3 цифры | 12345678 | Успешный платеж |
| MIR | PROVIDER_TEST_PAN | Любое будущее | любой 3 цифры | 12345678 | Успешный платеж |
| Виза (упадок) | PROVIDER_TEST_PAN | Любое будущее | любой 3 цифры | уменьшившийся |