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 table below provides general descriptions for error codes (
code), one error code can correlate with different values in thedescriptionfield.- The
errorstatus of the payment session is not final. Please contact Bank 131's support team and wait for a final transaction status.
Error code (code) | Error description | What you can do |
|---|---|---|
| 3DS_error | 3DS authentication failed | 3DS authentication have failed. 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 |
| 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 |
| amount_less_allowed_provider | The payment amount is less than acceptable | Change the payment amount |
| 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 |
| bank_card_expired | The bank card is past its expiration date | Check the input data for correctness and retry the attempt |
| binding_is_deactivated | The card is not verified for this agent | Binding is disabled. Contact the support team of the emitting bank |
| 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 |
| card_number_does_not_exist | Invalid card number | Check the card number for correctness and retry the attempt |
| confirm_timeout | Transaction canceled due to timeout | Retry the transaction |
| declined_by_issuer_bank | The operation was canceled by the emitting bank | Contact the support team of the emitting bank |
| format_error_amount | (FPS) Invalid format – amount to pay | Check the amount 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_full_name | (FPS) Invalid format – recipient's full name | Check the recipient's full name format and retry the attempt |
| 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 |
| 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 |
| idempotency_key_params_mismatch | The key has already been used for another session | Use another idempotency key |
| identification_error | Partner identification error | Check that the data is correct and retry the attempt |
| incorrect_card_data | Incorrect card data | Retry the operation with correct card data |
| incorrect_phone_number | Incorrect phone number | The phone number should contain a country code and 10 digits. For example: 71234567890 |
| insufficient_funds | The card does not have enough funds | The buyer does not have enough funds, retry the operation later |
| 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 |
| internal_error | Internal error | Retry the operation later. If the error persists, contact our support team |
| invalid_account | Invalid account | Check that the first five digits of the account number are among the allowed ones and retry the operation |
| invalid_recipient_full_name | (FPS) Incorrect recipient's full name details | Check the recipient's full name for correctness and retry the attempt |
| invalid_request | Invalid request | Check your request and retry the attempt (see Methods) |
| invalid_transaction | Invalid transaction | Check the data and retry the operation later. If the error persists, contact our support team |
| not_permitted_by_issuer_bank | The operation was not permitted by the emitting bank | Contact the support team of the emitting bank |
| not_permitted_to_card | The transaction is not permitted to the card holder | Contact the support team of the emitting bank |
| npd_service_internal_error | Self-employed service error | Retry the operation later. If the error persists, contact our support team |
| operation_rejected | The operation has been rejected for security reasons | Contact our support team |
| phone_number_is_not_associated | The phone number is not linked to this card | Link the card to the phone number of abandon the operation |
| phone_number_not_belong_card | Phone number check failed | The operation was canceled by the emitting bank. Contact the support team of the emitting bank |
| provider_exceeds_amount_limit | Exceeds the one-time deposit limit or the maximum amount of deposits (per day or per month) | Specify a smaller amount or a different period and retry the attempt |
| provider_foreign_transfer_prohibited | Transfer to a foreign card for this provider is prohibited | Select another card and retry the attempt |
| 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_timeout | Provider response timeout, transaction canceled | Retry the operation later. If the error persists, contact our support team |
| provider_wallet_invalid_account | An account (wallet) with this ID does not exist or is closed | Check the account ID for correctness |
| provider_wallet_is_blocked | The wallet is blocked | Contact the support team of the emitting bank |
| provider_wallet_not_identified | The wallet is not identified. Anonymous wallets cannot be topped up | Choose an identified wallet and retry the attempt |
| qr_expired | (FPS) QR code expired | Start the operation again |
| recipient_full_name_not_specified | Missing payee's full name | Specify a payee's full name |
| refund_amount_too_large | The refund amount exceeds the maximum permitted amount | Correct the refund amount and retry the operation |
| routing_internal_error | Payment condition determination error | Contact our support team |
| session_cancelled | The session has been canceled | If you did not canceled the session, contact our support team |
| 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 |
| session_lock_failed | Operation canceled for security reasons | Abandon your transaction or contact the support team |
| 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 |
| suspected_fraud | Suspicious transaction | The operation cannot be performed, contact our support team |
| 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 |
| taxpayer_not_bound | The self-employed person is not linked to Bank 131 | Link the self-employed person to Bank 131 |
| 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 |
| wallet_internal_error | Balance operation error | Retry the operation later. If the error persists, contact our support team |