Bank 131

Quick Start

1. Sign up at bank131.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 Bank 131 →

Overview

Bank 131 payment integration

Provider ID	bank131
Category	Bank Transfers
Website	bank131.ru

---

Configuration

Required Parameters

Parameter	Description
project	project identifier
closedkey	private key for signing requests

Example Configuration

{
  "env": "prod",
  "project": "project_id",
  "closedkey": "-----BEGIN PRIVATE KEY-----...",
  "currency": "rub",
  "save_card": true,
  "redirection_remap": true
}

---

Payment Flow

Payments (one-phase and two-phase):

Card payments:

1. create_session - session creation via POST /api/v1/session/init/payment/sync:
   • payment_details: card (number, expiration, cardholder, security_code)
   • amount_details, customer, payment_options (return_url, recurrent)
   • metadata
   • Retrieval session.id and customer_interaction (redirect or QR)

SBP payments:

1. create_session - session creation with type="faster_payment_system"
2. create_sbp_payment - SBP creation payment via POST /api/v1/session/start/payment:
   • payment_details: type="faster_payment_system"
   • customer.reference
   • payment_options: return_url, recurrent
   • Retrieval QR or redirect URL

Saved card (recurrent):

1. create_session - session with type="recurrent" and token cards from base

Apple Pay / Google Pay:

1. create_session - session with secured_card (apple_pay/google_pay token)

Payouts (one-phase):

Card payouts:

1. create_session - payout session creation via POST /api/v1/session/init/payout:
   • payment_method: card → bank_card (number)
   • amount_details, participant_details (recipient.full_name)
   • customer.reference, metadata

SBP payouts:

1. create_session - payout via POST /api/v1/session/init/payout:
   • payment_method: bank_account → faster_payment_system (phone, bank_id, description)
   • amount_details, metadata

Fiscalized payouts:

1. create_session - via POST /api/v1/session/init/payout/fiscalization:
   • fiscalization_details: professional_income_taxpayer (tax_reference, payer_type, payer_tax_number, payer_name, services)

Two-phase operations:

1. verify → create_session (authorize)
2. commit → POST /api/v1/session/confirm (capture)

Additionally:

• configure for SBP payouts: GET /api/v1/fps/banks - retrieving list banks
• refund: POST /api/v1/session/refund - refund
• balance: POST /api/v1/wallet/balance - check balance
• widget: POST /api/v1/token - retrieval token for widget

---

Status Mapping

Provider Status	4pay Status	Description
in_progress	new
ready_to_confirm	new
ready_to_capture	authorized
pending	action_required
action_required	action_required
payment_finished	charged
accepted	charged
payout_finished	paid
payment_refunded	refunded
declined	rejected
cancelled	rejected
succeeded	charged

---

Resources

• Official Documentation