Documentation

Documentation

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

›Payout Methods

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

Payout to a Russian bank card

You can send payments to Russian bank cards in two ways:

  • using the widget, where your recipient enters their card details, and you get tokenized card details and pass those in your payout request;
  • or with open parameters, if you have a PCI DSS certificate.

Mandatory payout parameters

For payouts to Russian cards, it is mandatory to provide the recipient's full name, exactly as it is stated in their passport: not a made-up name, and not a random sequence of symbols. You can write it in Cyrillic or in the Latin alphabet, whichever you prefer. Just giving the name printed on the recipient's card (cardholder name) is insufficient.

Russian bank card with tokenized details

Mandatory parameters to perform a payout to a Russian bank card with tokenized details obtained via the widget. Consider this option if you do not have a PCI DSS certificate.

NameTypeDescription
payment_methodPaymentMethodPayment data
typestringvalue: card
cardCardPaymentMethodBank card payment details
typestringvalue: encrypted_card
encrypted_cardEncryptedCardCard with encrypted fields
number_hashstringCard number hash
amount_detailsAmountDetailsThe amount
amountintThe amount in ruble decimal format. The value must be greater than zero. If you are sending 100 rubles, you will need to specify 10000
currencystringThe ISO 4217 currency code. Case insensitive. Always: rub
participant_detailsParticipantDetailsInformation on payout participants
recipientParticipantRecipient's details
full_namestringRecipient's name (as it appears on the passport)
beneficiary_idstringThe INN of the beneficiary. Mandatory only for payouts from a nominal account.
payment_detailsPaymentDetailsInformation about a transaction (type, description) Mandatory only for payouts from a nominal account
typestringValue: internal_transfer
internal_transferInternalTransferInfoInformation about an internal transfer
typestringValue: transfer_from_nominal_account
transfer_from_nominal_accountTransferFromNominalAccountInformation about a transfer from a nominal account
descriptionstringDescription

Russian bank card with unencrypted data

Mandatory parameters to perform a payout to a Russian bank card with open parameters collected on your side. Can be used if you have a PCI DSS certificate.

NameTypeDescription
payment_methodPaymentMethodPayment details (card, bank account etc.)
typestringvalue: card
cardCardPaymentMethodBank card payment details
typestringvalue: bank_card
bank_cardBankCardUnencrypted card
numberstringCard number
amount_detailsAmountDetailsThe amount
amountintThe amount in ruble decimal format. The value must be greater than zero. If you are sending 100 rubles, you will need to specify 10000
currencystringThe ISO 4217 currency code. Case insensitive. Always: rub
participant_detailsParticipantDetailsInformation on payout participants
recipientParticipantRecipient's details
full_namestringRecipient's name (as it appears on the passport)
beneficiary_idstringThe INN of the beneficiary. Mandatory only for payouts from a nominal account.
payment_detailsPaymentDetailsInformation about a transaction (type, description) Mandatory only for payouts from a nominal account
typestringValue: internal_transfer
internal_transferInternalTransferInfoInformation about an internal transfer
typestringValue: transfer_from_nominal_account
transfer_from_nominal_accountTransferFromNominalAccountInformation about a transfer from a nominal account
descriptionstringDescription

How to perform the payout

To make a payout select one of the following scenarios:

  • via the widget, , which means that tokenized parameters are passed (without PCI DSS);
  • with open parameters (if you have PCI DSS).
  • a payout from a nominal account.
← FiscalizationTo a Russian bank account →
  • Mandatory payout parameters
    • Russian bank card with tokenized details
    • Russian bank card with unencrypted data
  • How to perform the payout
Documentation
Documentation
PayoutsPaymentsAPI ReferenceService documents
Step by step
Payout to a card via widgetPayout to a card with PCI DSSPayout to the self-employed Paying via payment form
Get in touch
Ideas and partnerships — partners@131.ruMedia — press@131.ru
© 2023 Bank 131