Documentation

Documentation

  • Bank 131 API
  • Languages iconEnglish
    • Русский

›How Payments Work

131 Documentation

  • API features
  • Where to begin

Introduction to API

  • Interaction
  • API libraries
  • Testing
  • Version history

How Payouts Work

  • Features
  • How it all works
  • Main payout scenario
  • Payout refunds
  • The Self-employed

    • Payouts to the self-employed
    • Linking the self-employed
    • Fiscalization

    Payout Methods

    • To a Russian bank card
    • To a Russian bank account
    • To a QIWI Wallet
    • To a YooMoney (Yandex.Money)
    • To the Russian Federal Tax Agency
    • Via FPS by a phone number

    Payout Scenarios

    • Payout to a card via widget
    • Payout from a nominal account to a bank card
    • Single-request payout
    • Payout to a card with PCI DSS
    • Payout to a self-employed person with fiscal receipt

How Payments Work

  • Features
  • Payment process
  • Payments via bank card
  • Payments with later capture
  • Refunds
  • Recurring payments
  • Payments via FPS by QR code
  • Payments via Telegram

    • How to create your Telegram bot
    • How to connect your Telegram bot
    • How to setup your Telegram bot

    Split Payments

    • Features and options
    • Split payments out of the box
    • Split payments using API

    Payment Scenarios

    • Paying via payment form
    • Paying with PCI DSS
    • Single-request payment

Widgets

  • Widget to get card details
  • Payment form widget
  • Widget for linking a self-employed person to the Bank

Passport Verification

  • Features
  • Interaction
  • Methods

    • Verification request
    • Verification status
  • Response and errors

Reports

  • Payouts report
  • Payments report
  • Monthly report

API Reference

  • Objects
  • Methods
  • Webhooks
  • Error codes

Payments via bank card

You can accept payments by Visa, Mastercard, or MIR cards.

Card payment scenario

  1. You create a payment session that is separate from the actual payment (session/create) or a single combined session (session/init/payment).

At this point, you can connect the payment form widget.

  1. If you are not using the widget and have created the session separately from the start of the payment, you then need to send the session/start/payment request.
  2. Bank 131 sends you the ready_to_confirm webhook, which means that the Bank is ready to make the payment and is waiting for your confirmation.
  3. You confirm (confirm_request) or cancel (cancel_request).
  4. If you are making a payment without a payment form, Bank 131 sends you the webhook action_required. This means that you will need to take additional action to perform the payment. For instance, the user might need to go through 3-D Secure.
  5. Redirect the user to the address for 3-D Secure.
  6. Bank 131 sends you the payment_finished webhook containing the result of the payment. If the status is succeeded, this tells you that the payment was successful.