Códigos de error

03 julio 2025

Esta página enumera los códigos de error y sus significados para el servicio Card Payouts. Estos errores pueden ocurrir durante la tokenización de tarjetas, el envío de fondos o la consulta de transacciones.

Manejo de Errores

Cuando ocurre un error, la API responderá con un código y detalles adicionales. A continuación, se muestra un ejemplo de una respuesta de error:

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

Tabla de Códigos de Error

Código	Mensaje	Código de Estado HTTP
E004	ID de comercio no válido.	`400 Bad Request`
E008	Token incorrecto.	`400 Bad Request`
E009	El comercio no tiene fondos suficientes.	`400 Bad Request`
E010	El procesador no existe.	`400 Bad Request`
E025	Tarjeta inválida.	`400 Bad Request`
E040	El ID de comercio no corresponde a la credencial enviada.	`400 Bad Request`
E044	Marca de tarjeta no soportada.	`400 Bad Request`
E049	Token utilizado anteriormente.	`400 Bad Request`
E057	La moneda enviada es diferente a la definida por el procesador.	`400 Bad Request`
E228	Procesador inalcanzable.	`500 Internal Server Error`
E701	Ocurrió un error al enviar la petición HTTP.	`500 Internal Server Error`
E702	Ocurrió un error al enviar la transacción a la franquicia.	`500 Internal Server Error`
E704	Ocurrió un error al consultar la transacción con la franquicia.	`500 Internal Server Error`
E705	Ocurrió un error al consultar la transacción.	`500 Internal Server Error`
E706	Transacción no encontrada.	`404 Not Found`
E707	ID de transacción no válido.	`400 Bad Request`
E708	Ocurrió un error al consultar el servicio de validación de tarjeta.	`500 Internal Server Error`
E709	El token ingresado pertenece a otro comercio.	`400 Bad Request`
E710	El campo `paymentType` enviado no es válido.	`500 Internal Server Error`
E711	Ocurrió un error al guardar el token.	`500 Internal Server Error`
E712	El ID de la suscripción no es válido.	`400 Bad Request`
E713	El token de la suscripción ya ha sido eliminado previamente.	`400 Bad Request`
E714	Ocurrió un error al actualizar la suscripción.	`500 Internal Server Error`
E715	El comercio no posee configuración PCI.	`400 Bad Request`
E030	Fallo en la ejecución de InvokeLambda.	`500 Internal Server Error`

Errores `E027` y `E70`

En caso de que recibas un error E027:

E027: {
    Code:       E027.String(),
    Message:    "Ocurrió un timeout al enviar la petición a la franquicia.",
    StatusCode: errors.RequestTimeout,
}

O un error E703:

E703: {
        Code:       E703.String(),
        Message:    "Estado de la transacción desconocida.",
        StatusCode: errors.InternalServerError,
}

Antes de realizar cualquier reintento, debes esperar al menos 1 minuto después de haber recibido el error y consultar el estado final de la transacción utilizando el método Get transaction status.

Manejo de Errores

Tabla de Códigos de Error

Errores E027 y E70

Errores `E027` y `E70`