T-Bank SBP

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 SBP →

Overview

T-Bank SBP payment integration

Provider ID	tinkoff_sbp
Category	Bank Transfers
Website	tbank.ru

Supported operations: Payments Status Payouts

---

Configuration

Required Parameters

Parameter	Description
terminal_key	terminal key Tinkoff for identification merchant
terminal_pass	terminal password for generation signing requests
notification_url	URL for webhook-notifications from Tinkoff

Optional Parameters

Parameter	Description
currency	currency code in numeric format ISO 4217

Example Configuration

{
  "provider": "tinkoff_sbp",
  "provider_params": {
    "terminal_key": "1658754661102",
    "terminal_pass": "pxiufw02pli5uq4m",
    "notification_url": "https://merchant.com/webhooks/tinkoff",
    "currency": "643",
    "returnUrl": "https://merchant.com/success",
    "failUrl": "https://merchant.com/fail"
  }
}

---

Payment Flow

Payments - two-step process

Step 1: Initialization payment (/Init/)

1. Creating signature (Token) from concatenation parameters with password
2. Sending POST /Init/ with:
   • Amount, currency, description
   • URL' for success/failure/notifications
   • TerminalKey and calculated Token
3. Returns PaymentId and initial status

Step 2: Retrieval QR-code (/GetQr)

1. Creating new signature for request QR
2. Sending POST /GetQr with PaymentId
3. Returns QR-code in field Data (usually a link like https://qr.nspk.ru/...)
4. QR-code returns in auth_params.redirect

Status Check

Endpoint: POST /CheckOrder

Parameters:

• OrderId: order ID (transaction ID)
• TerminalKey and Token (signature)

Feature: API returns array Payments, need to find payment with required PaymentId.

---

Resources

• Official Documentation