T-Bank

Quick Start

1. Sign up at tbank.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 T-Bank →

Overview

T-Bank payment integration

Provider ID	tbank
Category	Bank Transfers
Website	tbank.ru

Supported operations: Payments Payouts Status 3DS

---

Configuration

Required Parameters

Parameter	Description
terminal_key	terminal key TBank for identification merchant
terminal_password	terminal password for generation signing (Token)

Optional Parameters

Parameter	Description
currency	currency code in numeric format ISO 4217

Example Configuration

{
  "provider": "tbank",
  "provider_params": {
    "terminal_key": "your_terminal_key",
    "terminal_password": "your_secure_password",
    "currency": "643",
    "returnUrl": "https://merchant.com/success",
    "failUrl": "https://merchant.com/fail"
  }
}

---

Payment Flow

Payments (payments) - multi-stage process

Stage 1: Initialization (/Init)

1. Creating Payment in the system TBank
2. Returns PaymentId
3. Returns initial status

Stage 2: Check 3DS (/Check3dsVersion)

• For card payments version is verified 3DS
• Necessity is determined challenge

Stage 3: Authorization completion (/FinishAuthorize)

• Card data is sent
• In progress 3DS if required
• Returns final status or redirect on 3DS

SBP payments: (/GetQr)

• For SBP is requested QR-code
• Returns link for payment

Payouts (payouts) - two-step process

Stage 1: Init (/Init)

• Creating payout with CardData
• CardData contains encrypted recipient card information

Stage 2: Payment (confirmation)

• Payout being confirmed
• Returns status execution

Status Mapping

For card payments/payouts: /GetState

For SBP: /CheckOrder (returns array Payments)

---

Resources

• Official Documentation