Errors

Our API will notify you if an error occurs when making any request to our services.

Error object

Field	Type	Description
request_id	string	Unique identifier of the request.
category	string	Error type.
message	string	Human-readable message that provides details about the error. This message should be displayed to the user and is available in English and Spanish.
timestamp	string	Indicates the moment the error occurred.
code	string	Short code that indicates the reported error.

Error response example

{
  "request_id": "664bec7ff960e690abcdb507afa50d28",
  "category": "ERROR",
  "message": "The URL to redirect the customer after the checkout is completed is required.",
  "timestamp": "1716251775442",
  "code": "BAD_REQUEST"
}

Error codes

List of possible error codes.

Code	HTTP Error	Message
BAD_REQUEST	400	The request is invalid, please check the request and try again.
INVALID_PARAMETERS	400	Some parameters have invalid values or format. Please refer to the documentation.
MISSING_PARAMETERS	400	Some required parameters are missing. Please refer to the documentation.
INVALID_STATUS	400	The current resource status does not allow this operation. Please refer to the documentation.
INVALID_TOKEN	401	Invalid token. Maybe it has expired or was revoked.
INVALID_CREDENTIALS	401	Invalid credentials. Please check your client id and secret.
AUTHORIZATION_REQUIRED	403	Authorization required, you do not have the required permissions to perform this operation.
METHOD_NOT_SUPPORTED	405	The server does not implement the requested HTTP method.
RESOURCE_CONFLICT	409	Request cannot be processed as it conflicts with another request.
PRECONDITION_REQUIRED	428	Request cannot be processed because it does not meet a precondition.
UNAVAILABLE_PAYMENT_METHOD	428	The payment method is not available yet, check if you have configured it correctly.
RESOURCE_NOT_FOUND	404	Required resource not found, please contact support.
PAYMENT_NOT_FOUND	404	The payment_id does not exist.
CUSTOMER_NOT_FOUND	404	The customer_id does not exist.
ORDER_NOT_FOUND	404	The order_id does not exist.
CHECKOUT_NOT_FOUND	404	The checkout_id does not exist.
PAYMENT_METHOD_NOT_FOUND	404	The payment_method_id does not exist or is not available anymore. Maybe you created it using one_time_use=true.
GATEWAY_TIMEOUT	500	Provider timeout, please try again later.
SERVICE_UNAVAILABLE	500	Provider is temporarily unavailable, please try again later.
INTERNAL_SERVER_ERROR	500	Internal server error