VTB

Quick Start

1. Sign up at vtb.ru and obtain API credentials
2. Create a terminal in the Admin Console with the parameters below
3. Start processing — the adapter is pre-built and ready to use

Go to VTB →

Overview

VTB payment integration

Provider ID	vtb
Category	Bank Transfers
Website	vtb.ru

Supported operations: Payouts Status Payments

---

Configuration

Required Parameters

Parameter	Description
username	login for authentication in the system VTB
password	password for authentication in the system VTB
callback_url	URL for notifications about status changes payment

Example Configuration

{
  "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"
  }
}

---

Payment Flow

Payouts (payout) - single-phase algorithm

Payout process includes two step:

Step 1: Payment registration (/register.do)

1. Sending POST request with data payment
2. Returns orderId (outertxid) from VTB
3. If error - returns error message

Step 2: Retrieval dynamic QR-code (/sbp/c2b/qr/dynamic/get.do)

1. Request is sent with mdOrder (received orderId)
2. Returns QR-code for payment via SBP
3. Returns:
   • outertxid: order ID VTB
   • status: status QR-code (mapped)
   • auth_params: contains qr_id and qr_payload for display QR-code

Status Check

Endpoint: POST /sbp/c2b/qr/status.do

Parameters:

• mdOrder: order ID (provider order ID)
• qrId: ID QR-code from auth_params

Returns status transactions.

---

Status Mapping

Provider Status	4pay Status	Description
"STARTED"	new
"CONFIRMED"	charging
"ACCEPTED"	charging
"REJECTED"	rejected
"REJECTED_BY_USER"	rejected
"CREATED"	new
"DEPOSITED"	charged
"DECLINED"	rejected

---

Resources

• Official Documentation