Documentation

Documentation

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

›The Self-employed

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 foreign 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
    • 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
  • Integration with Google Pay™
  • Payments via Telegram
  • Payments via FPS by QR code
  • 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
    • Google Pay™

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

Payouts to the self-employed

Self-employed people are individuals who have registered with the Federal Tax Agency and pay professional income tax.

Bank 131 is an official partner of the Federal Tax Agency. All operations performed with self-employed people via this API are approved by the Federal Tax Agency and have undergone joint testing.

API features

  • performing payouts to the self-employed with fiscal receipt (i.e. registering their income with the Federal Tax Agency);
  • obtaining a link to a receipt after a successful payout (this is needed for accounting to verify your transactions with self-employed people).

What you need to perform payouts

1. The recipient needs to have independently registered as self-employed with the Federal Tax Agency

This can be done:

  • in the iOS app
  • in the Android app
  • in the professional income tax taxpayer's personal account on the Federal Tax Agency website

2. The self-employed person needs to be linked to Bank 131

You check whether the individual is in fact self-employed and is linked to Bank 131 using their INN. If the INN does belong to the self-employed person but is not linked to the bank, you can link it right away.

How to link the self-employed person to the Bank

The scenario of payouts to self-employed people

Payouts to the self-employed are performed as in the general scenario, but the payout request needs to be supplied with the details necessary for receiving fiscal receipts.

  1. You create a payout session separate from the payment itself (session/create) or a single, combined, session (session/init/payout/fiscalization).

    • If you create a payout, you immediately pass the method of receiving the payout, all the parameters necessary for this method, and the fiscalization details.

    • If you are going to connect the widget, you will need to send a request for token creation to access the JavaScript library. You show the widget to the user and obtain their card details.

  2. If you have created the session separately from the start of the payout, you then send the request to start the payout (session/start/payout/fiscalization).

  3. Bank 131 then sends you the ready_to_confirm webhook, which means that the Bank is ready to perform the payout and is waiting for your confirmation.

  4. You confirm (confirm_request) or cancel (cancel_request).

  5. Bank 131 sends you the payment_finished webhook containing the result of the payout. If the status is succeeded, the payout has been performed successfully.

Payouts to the self-employed, step by step

What to check during the payout

Bank 131 performs the payout only if the income in question can be registered with the Federal Tax Agency. If the self-employed person has lost their status or has exceeded the maximum allowed income (the legal maximum is 2.4 million rubles a year), the payout will not succeed.

You only need to check the status of the self-employed person if you want to link them to the Bank.

← Payout refundsLinking the self-employed →
  • API features
  • What you need to perform payouts
    • 1. The recipient needs to have independently registered as self-employed with the Federal Tax Agency
    • 2. The self-employed person needs to be linked to Bank 131
  • The scenario of payouts to self-employed people
  • What to check during 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
© 2022 Bank 131