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/Inactive account | Check that the first five digits of the account number are among the allowed ones and retry the operation. If this error is received while transferring money, the account is blocked or not found |
| 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 |
| rate_has_changed | The conversion rate has changed | Retry the operation |
| recipient_account_not_found | The recipient's account is inactive | The account is not found or blocked |
| recipient_activity_count_exceeded | The allowed recipient's balance has been exceeded | Abandon the operation |
| recipient_full_name_not_specified | Missing payee's full name | Specify a payee's full name |
| recipient_is_blocked | Recipient blocked | Abandon the operation |
| recipient_not_found | Recipient not found | Make sure the recipient's details are correct |
| 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 |
| sender_account_not_found | Payer's account not found | Make sure the payer's account is correct |
| sender_is_blocked | Payer blocked | Abandon the operation |
| sender_not_found | Payer not found | Make sure the payer's details are correct |
| 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 |