Errores

Por medio de nuestro API, podrás ser notificado con toda la información en caso de cualquier error al momento de crear cualquier solicitud de retiro en efectivo.

{
    "details": [
        {
            "debug_message": "The \"allowed_payout_methods\" is missing.",
            "message": "El parametro \"allowed_payout_methods\" es requerido.",
            "param": "allowed_payout_methods",
            "code": "conekta.errors.parameter_validation.allowed_payout_methods.missing"
        }
    ],
    "object": "error",
    "type": "parameter_validation_error",
    "log_id": "6334dc60cae77f0001abe0c0"
}

Parámetros

Parámetro	Descripción	Tipo
type	Contiene el tipo de error y el código del error.	string
log_id	El id del log de la petición http está registrado en este error.	string
details	Lista detallada de los errores.	array
message	Mensaje legible para humanos el cual provee más detalles sobre el error. Este mensaje debe ser desplegado al usuario y está disponible en inglés y español.	string
debug_message	Mensaje legible para humanos el cual provee más detalles sobre el error. Este mensaje debe ser usado internamente para depuración y solo está disponible en inglés.	string
code	Un código corto y específico detallando processing_error.	string
params	El parámetro al cual este error está relacionado. Puedes usar este error para subrayar campos de texto erróneos.	string

Descripción de errores

Tipo	HTTP Code	Descripción
api_error	500	Error inesperado por parte de Conekta.
authentication_error	401	La llave usada en esta petición era inválida o no tiene permisos para ejecutar esta petición.
conflict_error	409	Se genera por un conflicto de versiones, lo más probable es que la versión que se envía en los encabezados de la petición sea incorrecta.
malformed_request_error	400	El JSON del cuerpo de la petición era inválida o la codificación de caracteres en la petición es incorrecta.
parameter_validation_error	422	Algún parámetro de la petición falta o tiene valores inválidos, consulta el atributo details en la petición para ver cuáles campos fueron inválidos y por qué.
processing_error	402	Se genera cuando existe un error en el proceso de retiro, puede ser por falta de balance o error de comunicación interna.
resource_not_found_error	404	El valor a ejecutar en la petición no existe. Ocurre normalmente cuando las llaves de la petición corresponden a otra cuenta o no tienen permisos para buscar este objeto.

Errores de tipo: processing_error

Existen casos especiales en los que un tipo de error puede tener diferentes descripciones de error, el detalle se puede encontrar dentro del parámetro message o debug_message.

Mensaje	Descripción
Hubo un problema al procesar la petición. (Payout order 62956032-3022-469a-813f-7d838b3f7651 found.)	Ocurre cuando una transacción no se encuentra.
Hubo un problema al procesar la petición. (The field Reason must be a string or array type with a maximum length of '40'.)	Un parámetro no cumple las especificaciones requeridas.
Hubo un problema al procesar la petición. (Cannot create balance retention)	No tiene saldo suficiente para realizar una referencia de retiro.
Hubo un problema al procesar la petición. (Payout order status Expired is invalid.)	No se puede realizar la operación con un estatus no válido.