Error Codes

July 03, 2025

This page lists the error codes and their meanings for the Card Payouts service. These errors may occur during card tokenization, fund transfers, or transaction queries.

Error Handling

When an error occurs, the API will respond with a code and additional details. Below is an example of an error response:

{
    "code": "E030",
    "details": {
        "Origin": "AccountInfoMiddleware | getBinInfo",
        "Message": "InvokeLambda has failed"
    },
    "message": "Internal Server Error"
}

Error Code Table

Code	Message	HTTP Status Code
E004	Invalid merchant ID (ID de comercio no válido).	`400 Bad Request`
E008	Incorrect token (Token incorrecto).	`400 Bad Request`
E009	The merchant does not have sufficient funds. (El comercio no tiene fondos suficientes.)	`400 Bad Request`
E010	The processor does not exist. (El procesador no existe).	`400 Bad Request`
E025	Invalid card. (Tarjeta inválida.)	`400 Bad Request`
E040	The merchant ID does not match the provided credential. (El ID de comercio no corresponde a la credencial enviada.)	`400 Bad Request`
E044	Unsupported card brand. (Marca de tarjeta no soportada).	`400 Bad Request`
E049	Token previously used. (Token utilizado anteriormente.)	`400 Bad Request`
E057	The submitted currency is different from the one defined by the processor. (La moneda enviada es diferente a la definida por el procesador.)	`400 Bad Request`
E228	Processor unreachable. (Procesador inalcanzable.)	`500 Internal Server Error`
E701	An error occurred while sending the HTTP request (Ocurrió un error al enviar la petición HTTP).	`500 Internal Server Error`
E702	An error occurred while sending the transaction to the card franchise. (Ocurrió un error al enviar la transacción a la franquicia).	`500 Internal Server Error`
E704	An error occurred while querying the transaction with the card franchise. (Ocurrió un error al consultar la transacción con la franquicia).	`500 Internal Server Error`
E705	An error occurred while querying the transaction. (Ocurrió un error al consultar la transacción).	`500 Internal Server Error`
E706	Transaction not found. (Transacción no encontrada.)	`404 Not Found`
E707	Invalid transaction ID. (ID de transacción no válido.)	`400 Bad Request`
E708	An error occurred while querying the card validation service. (Ocurrió un error al consultar el servicio de validación de tarjeta.)	`500 Internal Server Error`
E709	The entered token belongs to another merchant. (El token ingresado pertenece a otro comercio.)	`400 Bad Request`
E710	The `paymentType` field submitted is not valid. (El campo `paymentType` enviado no es válido)	`500 Internal Server Error`
E711	An error occurred while saving the token. (Ocurrió un error al guardar el token.)	`500 Internal Server Error`
E712	Invalid subscription ID. (El ID de la suscripción no es válido.)	`400 Bad Request`
E713	The subscription token has already been deleted. (El token de la suscripción ya ha sido eliminado previamente.)	`400 Bad Request`
E714	An error occurred while updating the subscription. (Ocurrió un error al actualizar la suscripción.)	`500 Internal Server Error`
E715	The merchant does not have PCI configuration. (El comercio no posee configuración PCI.)	`400 Bad Request`
E030	InvokeLambda execution failed. (Fallo en la ejecución de InvokeLambda.)	`500 Internal Server Error`

Errors `E027` and `E703`

If you receive an E027 error:

E027: {
    Code:       E027.String(),
    Message:    "Timeout occurred while sending the request to the franchise.",
    StatusCode: errors.RequestTimeout,
}```

Or an E703 error:

```json
E703: {
    Code:       E703.String(),
    Message:    "Unknown transaction status.",
    StatusCode: errors.InternalServerError,
}

Before attempting any retry, you must wait at least 1 minute after receiving the error and check the final status of the transaction using the Get transaction status method.

Error Handling

Error Code Table

Errors E027 and E703

Errors `E027` and `E703`