Bank 131

Быстрый старт

1. Подписаться at bank131.ru и получить API полномочия
2. Создать терминал в Консоль Admin с приведенными ниже параметрами
3. Начало обработки — адаптер предварительно построен и готов к использованию

Иди в банк 131 →

Обзор

Банк 131 Платежная интеграция

поставщик ID	bank131
Категория	Банковские переводы
Сайт	bank131.ru

---

конфигурация

Необходимые параметры

Параметр	Описание
project	идентификатор проекта
closedkey	приватный ключ для подписи запросов

Пример конфигурации

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

---

Платежный поток

Платежи (однофазные и двухфазные):

Карточные платежи:

1. Create_session - создание сеанса через POST /api/v1/session/init/payment/sync: (идентификаторы: create_session)
   • pay_details: карта (номер, срок действия, держатель карты, security_code) (идентификаторы: payment_details)
   • amount_details, customer, payment_options (return_url, recurrent)
   • метаданные
   • Retrieval session.id и клиент_взаимодействие (redirect или QR) (идентификаторы: customer_interaction)

SBP платежи:

1. Create_session - создание сеанса с типом="faster_payment_system" (идентификаторы: create_session)
2. Разработчик: Create_sbp_payment - SBP Оплата через создание через POST /api/v1/session/start/payment: (идентификаторы: create_sbp_payment)
   • payment_details: type="faster_payment_system"
   • Клиент.Ссылка
   • payment_options: return_url, recurrent
   • Поиск QR или перенаправить URL

Сберегательная карта (рекуррентная):

1. Create_session - сеанс с типом = "повторяющиеся" и маркерные карты с базы (идентификаторы: create_session)

Apple Pay / Google Pay:

1. Create_session - сеанс с secure_card (токенapple_pay/google_pay) (идентификаторы: create_session, secured_card)

Выплаты (одна фаза):

Выплаты по картам:

1. Create_session - создание сеанса оплаты через POST /api/v1/session/init/payout: (идентификаторы: create_session)
   • payment_method: card → bank_card (номер)
   • amount_details, participant_details (реципиент.full_name)
   • customer.reference, метаданные

SBP выплаты:

1. Create_session - оплата через POST /api/v1/session/init/payout: (идентификаторы: create_session)
   • payment_method: bank_account → faster_payment_system (телефон, bank_id, описание)
   • amount_details, метаданные

Фискализированные выплаты:

1. Create_session - через POST /api/v1/session/init/payout/fiscalization: (идентификаторы: create_session)
   • fiscalization_details: professional_ income_taxpayer (tax_reference, payer_type, payer_tax_number, payer_name, services) (идентификаторы: professional_income_taxpayer)

Двухфазные операции:

1. проверять Create_session (авторизация) (идентификаторы: create_session)
2. совершать → POST /api/v1/session/confirm (захват)

Дополнительно:

• конфигурировать для SBP выплаты: GET /api/v1/fps/banks - Получение списка банков
• возврат: POST /api/v1/session/refund - Возврат
• баланс: POST /api/v1/wallet/balance - Проверить баланс
• виджет: POST /api/v1/token Токен поиска для виджета

---

Картирование состояния

Статус поставщика	4pay Статус	Описание
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

---

Средства

• Официальная документация