Alfa-Bank

Quick Start

1. Sign up at alfabank.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 Alfa-Bank →

Overview

Alfa-Bank payment integration

Provider ID	alfabank
Category	Bank Transfers
Website	alfabank.ru

---

Configuration

Required Parameters

Parameter	Description
username	merchant login for API
password	merchant password for API

Example Configuration

{
  "env": "prod",
  "username": "merchant_login",
  "password": "merchant_password",
  "currency": "810"
}

---

Payment Flow

Payments (one-phase and two-phase):

1. start_tx - registration payment via POST /register.do:

   • userName, password, orderNumber (transaction ID)
   • amount, currency (old format: 810)
   • returnUrl, failUrl (via redirect proxy)
   • description
   • Retrieval orderId and formUrl (widget URL)

2. status - status check via POST /getOrderStatusExtended.do:

   • userName, password, orderId, orderNumber
   • Parsing orderStatus → map_status

Payouts (one-phase):

1. start_tx - payout creation via POST /performPayout.do:

   • userName, password, orderNumber (transaction ID)
   • amount, currency, description
   • target.pan (cardnumber)
   • Retrieval orderNumber and orderStatus

2. status - status check via POST /getPayoutStatus.do:

   • userName, password, orderNumber
   • Parsing orderStatus

---

Status Mapping

Provider Status	4pay Status	Description
-1	new
0	new
1	pre_authorized_3ds
2	charged
3	rejected
4	refunded
5	authorizing
6	rejected

---

Resources

• Official Documentation