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
    • 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 settlement account
    • Payout from an escrow account
    • Payout in a foreign currency
    • 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 QIWI wallet
  • 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

The Self-employed

  • General info
  • Linking
  • Testing
  • Verification
  • Notifying
  • Accruals

Reports

  • Payouts report
  • Payments report
  • Monthly report

API Reference

  • Objects
  • Methods
  • Webhooks
  • Error codes

Response and errors

Response processing

Analyze the response's HTTP code first.

If the response code is 200, check the status field.

If the status is ok, the request was a success. See more in data.

Response HTTP codes

200: Correct request, check status.

422: Request error. See more in error.description:

  • request_body_validation_error — Error in the request body
  • request_header_validation_error — Header x-partner-project is missing

500 — Error on Bank 131's side. Please send the request again later.

Status

Response statuses are passed in the status field.

ok: Request processed successfully. See more in data.

pending: Request is being processed. To find out the result, send the same request later.

error: Request processing error. See more in Error.

Error codes

Errors are passed in Error:

  • code contains the error code
  • description is the error description
codedescriptionError description
invalid_signSignature verification failureIncorrect check request signature
passport_validation_failure, inn_validation_failurePassport, inn validation failureThe data were not verified. Check the ID card number and taxpayer identification number and start the verification again
already_existsRequest with the same data already existsYou have already submitted these data for verification. To see the result, send the check{id} request with the previous verification's ID that you received in the data.id field.
request_not_foundRequest with given id not foundThe request with the given ID was not found
partner_project_not_foundpartner project not foundThe project ID sent in the header X-PARTNER-PROJECT does not exist
← Verification statusGeneral info →
  • Response processing
  • Response HTTP codes
  • Status
  • Error codes
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