Sberbank

Quick Start

1. Sign up at sberbank.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 Sberbank →

Overview

Sberbank payment integration

Provider ID	sber
Category	Bank Transfers
Website	sberbank.ru

Supported operations: Payments Status Payouts

---

Configuration

Required Parameters

Parameter	Description
login	merchant login for Sber API
pass	authentication password for Sber API

Optional Parameters

Parameter	Description
channel	Connection channel (optional) (default: mychannel)
bik	Bank BIC code (for card payments) (default: 044525225)
account	Settlement account (for card payments) (default: 40702810...)
fiscalization_mode	"external"
fiscalization_config_id	FiscalizationConfig.id for ATOL/OrangeData (default: 123)

Example Configuration

{
  "provider": "sber",
  "provider_params": {
    "login": "merchant-api",
    "pass": "secure_password",
    "returnUrl": "https://merchant.com/success",
    "failUrl": "https://merchant.com/fail"
  }
}

---

Payment Flow

Payments - two-step process

Step 1: Payment registration (/register.do)

1. Order is created in Sberbank system
2. Returns orderId (outertxid)
3. For SBP: returns sbolDeepLink for payment
4. For cards: orderId is saved for next step

Step 2: Order payment (/paymentOrder.do) - cards only

1. Card data is sent with orderId
2. Returns formUrl - 3DS or confirmation link
3. Returns in auth_params for user redirect

Payment Type Details

Card Payments (bank_card)

• Requires two requests: register + paymentOrder
• formUrl from paymentOrder is used for 3DS
• Card data is transmitted with prefixes $PAN, $CVC

SBP Payments (sbp)

• Only one request: register with SBP parameters
• Returns sbolDeepLink in externalParams
• User follows the link to pay in the banking app

Status Check

Endpoint: /getOrderStatusExtended.do

Parameters:

• orderId: order ID (provider order ID)
• userName and password

Returns:

• orderStatus - order status
• actionCode - action code (0 = success)
• actionCodeDescription - error description

---

Status Mapping

Provider Status	4pay Status	Description
0	new	Order registered, not paid
1	authorized	Pre-authorized amount held
2	charged	Fully authorized
3	rejected	Authorization cancelled
4	refunded	Refund processed
5	authorizing	ACS authorization initiated
6	rejected	Authorization declined

---

Testing

Sandbox URL

https://ecomtest.sberbank.ru/ecomm/gw/partner/api/v1

Test Cards

Card	Number	Exp	CVV	3DS Password	Result
Visa	4111 1111 1111 1111	any future	any 3 digits	12345678	Successful payment
Mastercard	5555 5555 5555 4444	any future	any 3 digits	12345678	Successful payment
MIR	2200 0000 0000 0053	any future	any 3 digits	12345678	Successful payment
Visa (decline)	4000 0000 0000 0002	any future	any 3 digits		Declined

---

Resources

• Official Documentation