Error codes
Please bear in mind that:
- The error codes may be changed without prior notice.
- Below are all the errors you can encounter when making either payments or payouts.
- The
errorstatus of the payment session is not final. Please contact Bank 131's support team and wait for a final transaction status.
| Code | Description | What you can do |
|---|---|---|
| identification_error | Partner identification error | Check that the data is correct and retry the attempt |
| authentication_error | Authentication error | Check the X-PARTNER-SIGN signature |
| authorization_error | Authorization error | You do not have enough privileges for the operation. Check your projects (X-PARTNER-PROJECT). Contact our support team |
| invalid_request | Invalid request | Check your request and retry the attempt (see Methods) |
| internal_error | Internal error | Retry the operation later. If the error persists, contact our support team |
| taxpayer_unknown | The person with this INN is not self-employed | Check the self-employed person's INN and status for correctness. Retry the attempt |
| taxpayer_not_bound | The self-employed person is not linked to Bank 131 | Link the self-employed person to Bank 131 |
| taxpayer_already_bound | The self-employed person is already linked to Bank 131 | Check the input data for correctness |
| taxpayer_income_exceeds_amount_limit | This ticket cannot be registered, it would exceed the self-employed annual amount limit (2,4 mln rubles) | Check the input data for correctness |
| provider_internal_error | Provider error | Retry the operation later. If the error persists, contact our support team |
| provider_issuer_unavailable | The provider issuer is unavailable | Retry the operation later. If the error persists, contact our support team |
| provider_foreign_transfer_prohibited | Transfer to a foreign card for this provider is prohibited | Select another card and retry the attempt |
| provider_exceeds_amount_limit | Exceeds amount limit for this provider | Specify a smaller amount and retry the attempt |
| provider_timeout | Provider response timeout, transaction canceled | Retry the operation later. If the error persists, contact our support team |
| session_cancelled | The session has been canceled | If you did not canceled the session, contact our support team |
| operation_rejected | The operation has been rejected for security reasons | Contact our support team |
| npd_service_internal_error | Self-employed service error | Retry the operation later. If the error persists, contact our support team |
| wallet_internal_error | Balance operation error | Retry the operation later. If the error persists, contact our support team |
| routing_internal_error | Payment condition determination error | Contact our support team |
| bank_card_expired | The bank card is past its expiration date | Check the input data for correctness and retry the attempt |
| declined_by_issuer_bank | The operation was canceled by the emitting bank | Contact the support team of the emitting bank |
| not_permitted_by_issuer_bank | The operation was not permitted by the emitting bank | Contact the support team of the emitting bank |
| insufficient_wallet_balance | The wallet does not have enough funds. You will get this error until the balance is replenished | Top up the balance and retry the operation |
| refund_amount_too_large | The refund amount exceeds the maximum permitted amount | Correct the refund amount and retry the operation |
| insufficient_funds | The card does not have enough funds | The buyer does not have enough funds, retry the operation later |
| session_wrong_state | Cannot perform a transaction in this status | Check the session status. If the session status is error, you cannot cancel it. To learn the reasons, contact our support team |
| capture_timeout | The transaction was canceled due to the confirmation timeout | No response came from you. Check the transaction status and the session status. If these statuses are unsuccessful and final, retry the operation |
| session_cancelled_by_partner | The session has been cancelled by the partner | If you canceled the session, start it again. If you did not canceled the session, contact our support team |
| card_number_does_not_exist | Invalid card number | Check the card number for correctness and retry the attempt |
| invalid_transaction | Invalid transaction | Check the data and retry the operation later. If the error persists, contact our support team |
| suspected_fraud | Suspicious transaction | The operation cannot be performed, contact our support team |
| activity_count_exceeded | The activity limit for the card has been exceeded | Check if the used card has any restrictions and retry the operation. If the error persists, contact our support team |
| not_permitted_to_card | The transaction is not permitted to the card holder | Contact the support team of the emitting bank |
| qr_expired | (FPS) QR code expired | Start the operation again |
| format_error_phone_number | (FPS) Invalid format — recipient's phone number | Check the recipient's phone number format and retry the attempt |
| format_error_recipient_bank_id | (FPS) Invalid format — recipient's bank ID in FPS | Check the recipient's bank ID format and retry the attempt |
| format_error_description | (FPS) Invalid format — purpose of payout | Check the payout purpose format and retry the attempt |
| format_error_amount | (FPS) Invalid format — amount to pay | Check the amount format and retry the attempt |
| format_error_full_name | (FPS) Invalid format — recipient's full name | Check the recipient's full name format and retry the attempt |
| invalid_recipient_full_name | (FPS) Incorrect recipient's full name details | Check the recipient's full name for correctness and retry the attempt |
| idempotency_key_params_mismatch | The key has already been used for another session | Use another idempotency key |
| idempotency_key_already_exists | The previous request with the same key is still in progress | Wait till the previous request is processed |
| idempotency_key_not_supported | This method cannot be used with an idempotency key | Do not use an idempotency key for this method. Check the list of methods supporting the idempotency key feature |
| invalid_account | Invalid account | Check that the first five digits of the account number are among the allowed ones and retry the operation |
| account_not_found | Account not found | Check the account number for correctness. If the account number is correct and the account belongs to you, but you receive this error anyway, contact our support team |