Skip to main content

Connecting the self-employed to Bank 131

To enable automatic fiscalization of receipts for your payouts via Bank 131, get the self-employed person's consent. To do this, create a connection request and send the received link to the self-employed person. By following the link, they will complete all the necessary steps and confirm their consent to fiscalization.

If the self-employed person has already been identified and connected to Bank 131 before, skip the steps below.

A self-employed person can give consent to the fiscalization of payouts from several partners, but each partner must create a separate connection request.

The service is only available to citizens of the Russian Federation with a Russian phone number.

Step 1. Create a connection request​

Send a self_employed/onboarding/create request to create a connection request. There is no limit on the number of requests—you can create as many as you need.

In the response, you will receive a link for the self-employed person and the request ID to check the connection status.

Request example
curl -X POST \
  https://demo.bank131.ru/api/v1/self_employed/onboarding/create \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "return_url": "https://131.ru/"
  }'

Send the link to the self-employed person in any convenient way, for example, by email.

The link is not linked to a particular person, so any self-employed person can start connecting using it. But if someone has already started connection, the link cannot be reused.

Self-employed person connection steps​

  1. Follows the link, accepts the connection terms, and agrees to be connected to you.
  2. Registers in their account. From that moment, they have 24 hours to complete the connection, otherwise they will have to start over.
  3. Passes identification.
  4. Passes the Federal Tax Service check. There are two possible scenarios:
    • if the person is not yet registered as a self-employed person—Bank 131 registers them with the FTS and immediately receives the necessary fiscalization permissions
    • if the self-employed person is already registered—Bank 131 sends a request to the FTS to grant them the permissions for the fiscalization of receipts, and the self-employed person approves it in their account). After that, Bank 131 checks the status with the FTS, and the connection is completed

If the identification or FTS check is declined, the self-employed person can try again, but there is no guarantee the connection will be completed successfully. The decline reasons may not depend on Bank 131.

Possible errors during connection​

  • No SMS code received — check the phone number and request the code again
  • Failed to confirm identity — make sure the document is fully readable and the data is clearly visible, then try again
  • Data mismatch FTS data — clarify the reason with the tax authority. The passport data may differ from the tax data
  • Tax authority refused registration — clarify the reason with the tax authority. The self-employed status may be unavailable due to restrictions
  • Access to account not confirmed — return to the account and request access again
  • More than 24 hours passed since connection started — start the connection again

Step 3. Check the connection status​

Send a self_employed/onboarding/status request passing the request ID obtained during the first step.

Request example
curl -X POST \
  https://demo.bank131.ru/api/v1/self_employed/onboarding/status \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "id": "019fd6ca-b080-798e-a1bf-eb7dc096e1de"
  }'

Self-employed connection diagram​

Self-employed person connection diagram

How to make a payout with fiscalization >