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 the Russian Federal Tax Agency

Starting from 2019 foreign companies shall pay VAT related to the delivery of e-services to Russian consumers. Now you can pay it with Bank 131.

VAT payment will be transferred to these bank details:

BIC: 004525988
Treasury Account: 03100643000000017300
Treasury Single Account: 40102810545370000003
Recipient: Federal Treasury Directorate for Moscow (FTS of Russia Interregional Inspectorate for Large Taxpayers 7)
INN: 7707500730
KPP: 770701001

How to enable

Inform your Bank 131 manager that you want to pay VAT and we will choose a convenient workflow and sign the agreement.

Possible scenarios

With automatic deduction

This scenario is for you if you accept payments with Bank 131 services and want to pay VAT for these payments.

In this case, Bank 131 will take the corresponding amount from every accepted payment and transfer it to the guaranty payment balance, exactly as much as is necessary for VAT.

With guarantee payment balance

This scenario looks like an ordinary payout: you send a guarantee payment to Bank 131, the Bank then executes your payout orders for VAT payments.

You can check the balance of your guarantee payment balance using the wallet/balance method.

More about this scenario

How to pay VAT

You can use the special method or make the standart payout with VAT parameters.

Option 1. Method alias/ru_vat_lite

Send a request to perform a payout using the alias/ru_vat_lite method. Specify tax period and amount in ruble decimal format. The tax amount will be transferred to the Federal Tax Agency.

Option 2. Payout with VAT parameters

Send a request session/init/payout:

  • in the payment_method.type parameter, pass value tax;
  • in the tax.typeparameter, pass value tax_short;
  • in the tax_details.period parameter, pass the tax period;
  • in the amount_details.amount parameter, pass the tax amount in ruble decimal format.

Mandatory parameters to VAT payments

NameTypeDescription
payment_methodPaymentMethodPayment data
typestringValue: tax
taxTaxPaymentMethodThe method of paying the tax
typestringTax payment type: tax_short
tax_shortTaxShortTax payment data with minimum set of parameters
tax_detailsTaxDetailsTax payment details
periodstringThe tax period
typestringThe period type. Possible values: month, quarter
numbernumberDepends on period type. Number from 1 to 12 for month, number from 1 to 4 for quarter
yearstringYear, 4 digits. Example: 2021
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

Request example

cURL
curl --location --request POST 'https://demo.bank131.ru/api/v1/session/init/payout' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: project' \
--data-raw '{
"amount_details": {
"amount": 20000,
"currency": "rub"
},
"payment_method": {
"type": "tax",
"tax": {
"type": "tax_short",
"tax_short": {
"tax_details": {
"period": {
"type": "quarter",
"number": 4,
"year": "2020"
}
}
}
}
}
}'

Successful response example

{
    "status": "ok",
    "session": {
        "id": "ps_2909",
        "status": "in_progress",
        "created_at": "2018-05-27T03:02:00.935351Z",
        "updated_at": "2018-05-27T03:02:00.935351Z",
        "payments": [
            {
                "id": "po_3230",
                "status": "in_progress",
                "created_at": "2018-05-27T03:02:00.935351Z",
                "payment_method": {
                    "type": "tax",
                    "tax": {
                        "type": "tax_short",
                        "tax_short": {
                            "tax_details": {
                                "period": {
                                    "type": "quarter",
                                    "number": 4,
                                    "year": "2020"
                                }
                            }
                        }
                    }
                },
                "amount_details": {
                    "amount": 20000,
                    "currency": "rub"
                }
            }
        ]
    }
}

← To a YooMoney (Yandex.Money)Via FPS by a phone number →
  • How to enable
  • Possible scenarios
    • With automatic deduction
    • With guarantee payment balance
  • How to pay VAT
    • Option 1. Method alias/ru_vat_lite
    • Option 2. Payout with VAT parameters
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