# 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

<table><thead><tr><th width="174.828125">Code</th><th>Meaning</th></tr></thead><tbody><tr><td>S0000001</td><td>Payment completed successfully.</td></tr></tbody></table>

## Error Codes

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

{% hint style="info" %}
**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.
{% endhint %}

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

<sup>*(All F-series codes share the same meaning.)*</sup>
