Error catalogue
| HTTP | When | Shape |
|---|---|---|
| 401 | Missing Authorization or invalid key |
{"message": "..."} |
| 404 (application) | The payment does not exist for that key | {"message":"Pago no encontrado."} |
| 404 (routing) | The route does not exist | {"message":"The route ... could not be found."} - always English |
| 405 | Wrong method | {"message":"The GET method is not supported for route ... Supported methods: POST."} |
| 422 | Validation or business rule | {"message":"...", "errors":{"field":["..."]}} |
A 422 message holds the first error, suffixed with (and N more errors) when there are several;
errors groups them by field. There are no machine-readable error codes: do not build logic on
string matching, because the text changes with Accept-Language and can be rewritten. Branch on the
HTTP status and on the keys of the errors object, which are stable.
15.1 Common 422 messages
| Message | Cause |
|---|---|
El campo amount es obligatorio. |
A required field is missing |
El campo amount debe ser al menos 0.01. |
Amount below the minimum |
La moneda seleccionada no esta disponible en su terminal de enlaces de pago. |
currency_code not enabled |
La fecha de vencimiento debe ser en el futuro. |
expires_at in the past |
El campo metadata debe ser un array. |
metadata sent as a string |
Ingrese un monto o porcentaje de impuesto cuando el impuesto esta habilitado. |
sales_tax_value missing |
El porcentaje no puede superar 100%. |
sales_tax_value above 100 in percentage mode |
Seleccione un tipo de propina o permita la seleccion del cliente en el checkout. |
tip_enabled without a mode |
Los limites de propina no pueden ser mayores que el monto del plan. |
tip_max_amount above amount |
El entorno sandbox no esta configurado para enlaces de pago... |
Sandbox not provisioned for that merchant (16.2) |