Documentation

Documentation

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

›Passport Verification

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

Features

In some cases, Bank 131 needs to verify the payment recipient before the transaction. It may be so if you cooperate with the self-employed on the agency basis (where the self-employed is your beneficiary and you are the agent receiving payments on their behalf) and send them payouts or split payments.

If you do not know if you have to verify the recipients, you do not need to.

How to set up interaction

Interaction with the API goes the other way than usual: you need to use CryptoPro to sign the requests.

Learn more about interaction

How to perform a verification

Step 1. Send the verification request

Send the check request with the individual's information, and Bank 131 will check the details in the IEIS.

You will receive the verification request ID.

Step 2. Check the result

Send the check/{id} request with the ID you received in the previous step.

It may take 10 minutes to 2 days before you get the verification result.

If it is all right (status success), send the money.

If you send a duplicate cheсkrequest with the same details (inn and agent_contract_number), you will get the error (description already exists) as a response to check/{id}.

In the error description you will receive the previous verification's ID by which you can learn its status.

Example of a response upon repeat verification

{
    "status": "error",
    "error": {
        "code": "already_exists",
        "description": "Request with the same data already exists"
    }
    "data": {
        "id": "7" // previous verification ID
       }
}

How Bank 131 knows the data are verified

When sending a payout to a self-employed, you need to specify the taxpayer identification number (INN in Russia) in the tax_reference field. This taxpayer identification number will let Bank 131 know that the self-employed has passed the verification.

← Widget for linking a self-employed person to the BankInteraction →
  • How to set up interaction
  • How to perform a verification
    • Step 1. Send the verification request
    • Step 2. Check the result
  • How Bank 131 knows the data are verified
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