Documentation

Documentation

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

›API Reference

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

Error codes

The error codes may be changed without prior notice.

NameDescription
identification_errorPartner identification error.
authentication_errorAuthentication error
authorization_errorAuthorization error
invalid_requestInvalid request
internal_errorInternal error
taxpayer_unknownThe person with this INN is not self-employed
taxpayer_not_boundThe self-employed person is not linked to Bank 131
taxpayer_already_boundThe self-employed person is already linked to Bank 131
taxpayer_income_exceeds_amount_limitThis ticket cannot be registered, it would exceed the self-employed annual amount limit (2,4 mln rubles)
provider_internal_errorProvider error
provider_issuer_unavailableThe provider issuer is unavailable
provider_foreign_transfer_prohibitedTransfer to the foreign card for this provider is prohibited
provider_exceeds_amount_limitExceeds amount limit for this provider
provider_timeoutProvider timeout
session_cancelledThe session has been canceled
operation_rejectedThe operation has been rejected for security reasons
npd_service_internal_errorSelf-employed service error
wallet_internal_errorBalance operation error
routing_internal_errorPayment condition determination error
bank_card_expiredThe bank card is past its expiration date
declined_by_issuer_bankThe operation was canceled by the emitting bank
not_permitted_by_issuer_bankThe operation was not permitted by the emitting bank
insufficient_wallet_balanceThe balance does not have enough funds
refund_amount_too_largeThe refund amount exceeds the maximum permitted amount
insufficient_fundsThe card does not have enough funds
session_wrong_stateCannot perform a transaction in this status
capture_timeoutThe transaction was canceled due to the confirmation timeout
session_cancelled_by_partnerThe session has been cancelled by the partner
card_number_does_not_existInvalid card number
invalid_transactionInvalid transaction
suspected_fraudSuspicious transaction
activity_count_exceededThe activity limit for the card has been exceeded
not_permitted_to_cardThe transaction is not permitted to the card holder
qr_expiredQR code expired
← Webhooks
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