VTB
Быстрый старт
- Подписаться at vtb.ru и получить API полномочия
- Создать терминал в Консоль Admin с приведенными ниже параметрами
- Начало обработки — адаптер предварительно построен и готов к использованию
Обзор
VTB Платежная интеграция
| поставщик ID | vtb |
| Категория | Банковские переводы |
| Сайт | vtb.ru |
Поддерживаемые операции: Payouts Status Payments
конфигурация
Необходимые параметры
| Параметр | Описание |
|---|---|
username | вход для аутентификации в системе VTB |
password | Пароль для аутентификации в системе VTB |
callback_url | URL для уведомлений об изменении статуса оплаты |
Пример конфигурации
{
"provider": "vtb",
"provider_params": {
"username": "merchant_login",
"password": "secure_password",
"callback_url": "https://merchant.com/webhooks/vtb",
"returnUrl": "https://merchant.com/success",
"failUrl": "https://merchant.com/fail"
}
}
Платежный поток
Выплаты (payouts) — однофазный алгоритм
Процесс выплаты включает в себя два этапа:
Шаг вперед 1Регистрация платежа (/register.do)
- Отправка POST Запрос с оплатой данных
- Возвращение
orderId(внешний) от VTB - Если ошибка - возвращает сообщение об ошибке
Шаг вперед 2Динамика поиска QRкод (/sbp/c2b/qr/dynamic/get.do)
- Запрос отправляется с
mdOrder(получено приказом Id) (идентификаторы:orderId) - Возвращение QRКод для оплаты через SBP
- Возвращение:
outertxidПорядок ID VTBstatusстатус: QR-код (карта)auth_paramsсодержитqr_idиqr_payloadдля отображения QRкод
Проверка статуса
Конечная точка: POST /sbp/c2b/qr/status.do
Параметры:
mdOrderПорядок ID (заказ поставщика) ID)qrId: ID QRКод из auth_params
Возвращает статусные транзакции.
Картирование состояния
| Статус поставщика | 4pay Статус | Описание |
|---|---|---|
"STARTED" | new | |
"CONFIRMED" | charging | |
"ACCEPTED" | charging | |
"REJECTED" | rejected | |
"REJECTED_BY_USER" | rejected | |
"CREATED" | new | |
"DEPOSITED" | charged | |
"DECLINED" | rejected |