Error codes
DocsLimited
Last updated: Oct 24th, 2:30am
Return the following error codes in the cancel URL that the merchant receives. The format for the error codes returned in the cancel URL is: example.com/checkout/cancel?errorcode=internal_server_error&token=XXX.
Note: The query parameters in the cancel URL are not case sensitive.
| Error code | Description |
|---|---|
UNPROCESSABLE_ENTITY |
The requested action could not be performed, semantically incorrect, or failed business validation. |
REQUIRED_PARAMETER_FOR_PAYMENT_SOURCE |
A required parameter for the Zip payment source is missing. Check the field location in the error response (For example, /payment_source/zip/phone or /purchase_units/0/invoice_id). |
payee_not_enabled_for_payment_method |
You are not authorized to accept this payment method. Ensure Zip is enabled for your account. |
min_amount_required_by_payment_method |
The transaction amount doesn't meet the minimum transaction requirement. Minimum is $35.00 USD for US or $0.01 AUD for Australia. |
max_amount_exceeded_by_payment_method |
The transaction amount exceeds the maximum limit. Maximum is $1,500 USD for US Pay in 4 or $50,000 AUD for Zip Money in Australia. |
currency_not_supported_by_payment_method |
The currency specified is not supported by Zip. Only USD and AUD are supported. |
country_not_supported_by_payment_method |
The country specified is not supported by Zip. Only US and AU are supported. |
declined_by_payment_method |
The transaction initiation was declined by Zip. |
payment_method_error |
The transaction initiation was declined by the payment method. |
session_timeout |
The Zip session has expired. Sessions expire after 10 minutes in the United States or 168 hours in Australia. |
internal_server_error |
This error includes: encryption/decryption, database connection issues, timeouts, and unknown errors. |
payment_error |
All other errors. |