Payment Error Codes

Zotlo standardizes all payment provider responses into a unified set of status and error codes. This ensures consistent behavior across different PSPs, easier debugging, and reliable handling of edge cases.

Each payment attempt returns one of the codes below.

Success Code

Code	Meaning
S0000001	Payment completed successfully.

Error Codes

Below is the full list of error codes returned by Zotlo.

Note:

All error codes starting with E indicate a recoverable payment failure.

Codes starting with F indicate fatal failures where the user must contact support or retry later.

Code	Meaning
E0000000	There was an issue with the payment. Please try again later.
E0000050	There was an issue with the payment. Please try again later.
E0000001	The transaction was terminated before clicking the payment button.
E0000002	The transaction failed due to insufficient card limit.
E0000003	Security verification could not be completed successfully.
E0000004	The transaction failed. Please contact your bank.
E0000005	A technical error occurred. Please try again.
E0000006	The payment process was canceled by the user.
E0000007	Your card is not enabled for online transactions. Please contact your bank.
E0000008	The transaction failed due to security policies.
E0000009	Invalid card number was entered.
E0000010	Incorrect card expiration date.
E0000011	The user did not approve the transaction.
E0000012	Transaction could not be completed because the limit was exceeded.
E0000013	Payment could not be completed due to an incorrect amount.
E0000014	3DS security verification failed; subscription could not be activated.
E0000015	Payment was not approved by the bank.
E0000016	Payment was not approved by your bank. Please contact them.
E0000017	Incorrect CVV code.
E0000018	The card was not approved. Try another card.
E0000019	Your credit card has expired.
E0000020	Verification code entered incorrectly multiple times.
E0000021	A technical error occurred. Please try again.
E0000022	Your card is not supported by the current payment provider.
E0000023	The card was not approved. Try another card.
E0000024	Card expiration year incorrect.
E0000025	Card expiration month incorrect.
E0000026	Card expiration date incorrect.
E0000027	Unexpected regional transaction restrictions.
E0000028	Insufficient balance in wallet.
E0000029	The card was not approved. Try another card.
F0000000 – F0000010	Your transaction could not be completed. Please contact customer service.

^{(All F-series codes share the same meaning.)}