Skip to content

API v.3 processing error codes

Info

Please note, the code updates are coming in line with API v.3 implementation.

API v.3 code Error Message Friendly message
0000 The operation is successful.
0001 - 0999 Error codes of the system validation and processing service for card transactions
0001 Failed to complete the transaction: Check the card details and, if they are correct, contact your bank to explain the reasons. The bank's phone number is indicated on the back of the card.
0002 Failed to complete the transaction: The card has expired.
0003 Failed to complete the transaction: CVV/CVC verification failed.
0004 Failed to complete the transaction: Insufficient funds.
0005 Failed to complete the transaction: contact your merchant to explain the reasons.
0006 Failed to complete the transaction: Terminal error during operation. Unsupported data entered or terminal failure. Use a different terminal.
0007 Failed to complete the transaction: Please try again later. If this error occurs again, contact your bank to explain the reasons. The bank's phone number is indicated on the back of the card.
0008 Failed to complete the transaction: Choose another payment method or contact your bank to explain the reasons. The bank's phone number is indicated on the back of the card.
0009 3-D Secure verification failed.
0099 Other error.
0500 - 0999 Error codes of the system validation and processing service for transactions that are initiated with alternative payment methods
0501 Failed to complete the transaction: Check the transaction details and if they are correct, contact your payment provider for clarification to explain the reasons.
0502 Failed to complete the transaction: The payment/order has expired.
0503 Failed to complete the transaction: Transaction validation error.
0504 Failed to complete the transaction: Insufficient funds.
0505 Failed to complete the transaction: Contact your merchant to explain the reasons.
0506 Failed to complete the transaction: Terminal error during operation. Unsupported data entered or terminal failure. Use a different terminal.
0507 Failed to complete the transaction: Please try again later. If this error occurs again, contact your payment provider for clarification to explain the reasons.
0508 Failed to complete the transaction: Choose another payment method or contact your payment provider for clarification to explain the reasons.
0509 Transaction processing. Please wait.
0599 Other error.
1000 - 1999 Error codes of the payment gateway service
1000 unknown_error
1001 unknown_route
1002 resource_not_found
1003 gateway_not_found
1004 shop_not_found
1005 invalid_gateway_request
1006 unsupported_gateway_type_for_shop
1007 unsupported_currency_for_shop
1008 unsupported_card_type_for_shop
1009 unacceptable_for_additional_rule
1010 unable_decrypt_card_data
1011 pan_data_is_restricted
1012 test_conditions_are_not_met
1013 test_set_is_empty
1014 test_set_is_differs
1015 live_card_is_banned
1016 unsupported_transaction_type
1017 missing_request_section
1018 duplicate_transaction
1019 transaction_is_processing
1020 welcome
1021 unauthorized
1022 forbidden
1023 bad_request
1024 unsupported_mime_type
1025 request_validation_error
1026 invalid_json
1027 payment_needed_for_credit
1028 absent_allowed_gateways
1029 invalid_google_merchant_token Invalid google merchant token. Invalid google merchant token.
1030 invalid_payment_token
1031 invalid_bpc_aft_params
1032 invalid_bpc_oct_params
1033 currency_not_found
1034 gateway_undefined
1035 balance_request_error
1036 expired_request
1037 visa_alias_phone_not_found Card Not Found. Card Not Found.
2000 - 3999 Error codes of the Smart Routing service
2001 faraday_error Smart Routing - Connection error. The transaction was declined due to security rules.
2002 validation_error Smart Routing - Validation error. The transaction was declined due to security rules.
2003 invalid_response Smart Routing - invalid response. The transaction was declined due to security rules.
2004 resource_not_found Smart Routing - resource not found. The transaction was declined due to security rules.
2005 exception_in_action Smart Routing - Exception in gateway action. The transaction was declined due to security rules.
2006 object_was_not_received The transaction was declined due to security rules. The transaction was declined due to security rules.
2007 rejected_by_be_protected Transaction didn't pass risk management system. Transaction didn't pass risk management system.
2008 rejected_by_action_flow Transaction didn't pass risk management system. Transaction didn't pass risk management system.
4000 - 4999 Error codes of the 3-D Secure verification service
4001 threeds2_failed
4002 ve_status_n 3-D Secure 1.0 Attempts Server is not available. 3-D Secure 1.0 Attempts Server is not available.
4003 ve_status_blank 3-D Secure service is temporarily unavailable. Please try later or contact with tech support.
4004 ve_status_not_valid
4005 belkart_pa_status_u_e_a
4006 verification_rule_failed Failed due to verification rule.
4007 service_unavailable 3-D Secure service is temporarily unavailable. Please try later or contact with tech support.
4008 not_valid_pa_res
4009 pa_status_n_e
4010 redirect_v1
4011 redirect_v2
5000 - 5999 Error codes of the MaxMind check service
5001 fail_by_score The transaction was failed due to failed MaxMind verification. The transaction was failed due to failed MaxMind verification.
6000 - 6999 Error codes of the AVS/ CVC verification check
6001 declined_by_verification Transaction was declined. Transaction was declined.
7000 - 7999 Error codes of the Verify service
7001 not_verified
8001 Error code of the P2P verification service
8001 not_verified
8010 Error code of the payment gateway service for requests in asynchronous mode
8010 initial Async transaction was created. Async transaction was created.
8011 - 9999 Bank error codes