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

    Payout Methods

    • To a Russian bank card
    • To a foreign bank card
    • To a Russian bank account
    • To a QIWI Wallet
    • To a YooMoney (Yandex.Money)
    • To the Russian Federal Tax Agency

    Payout Scenarios

    • Payout to a card via widget
    • 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
  • 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
  • Verification request
  • Verification status
  • HTTP codes

Reports

  • Payouts report
  • Payments report
  • Monthly report

API Reference

  • Objects
  • Methods
  • Webhooks
  • Error codes

Payout to a foreign bank card

You can send payments to foreign 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

When performing payouts to a foreign bank card, you need to specify the following:

  • card number;
  • amount in ruble decimal format (e.g. if you are paying 100 rubles, you will need to pass 10000 in the amount_details.amount field);
  • payer details: name, company name, address, country, city;
  • recipient's name.

Foreign bank card with tokenized details

Mandatory parameters to perform a payout to a foreign 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
currency stringThe ISO 4217 currency code. Case insensitive. Always: rub
participant_detailsParticipantDetailsInformation on payout participants
sender ParticipantSender's details
full_namestringName
company_namestringCompany name
address_linestringAddress
country_iso3 stringThe country (ISO-3166-1 alpha-3)
citystringThe city
recipientParticipantRecipient's details
full_namestringRecipient's name

Foreign card with open parameters

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

NameTypeDescription
payment_methodPaymentMethodPayment data
type stringvalue: card
card CardPaymentMethodBank card payment details
type stringvalue: bank_card
bank_cardBankCardUnencrypted bank card
number stringCard 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
currency stringThe ISO 4217 currency code. Case insensitive. Always: rub
participant_detailsParticipantDetailsInformation on payout participants
sender ParticipantSender's details. Important: Sender is an individual.
full_namestringName
company_namestringCompany name
address_line stringAddress
country_iso3stringThe country (ISO-3166-1 alpha-3)
city stringThe city
recipientParticipantRecipient's details
full_namestringRecipient's name

How to perform the payout

There are two ways:

  • via the widget, which means that tokenized parameters are passed (without PCI DSS);
  • with open parameters (if you have PCI DSS).
← To a Russian bank cardTo a Russian bank account →
  • Mandatory payout parameters
  • Foreign bank card with tokenized details
  • Foreign card with open parameters
  • How to perform the payout
Documentation
Documentation
PayoutsPaymentsAPI Reference
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
© 2021 Bank 131