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 devolución.

{
    "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ámetroDescripciónTipo
typeContiene el tipo de error y el código del error.string
log_idEl id del log de la petición http está registrado en este error.string
detailsLista detallada de los errores.array
messageMensaje 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_messageMensaje 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
codeUn código corto y específico detallando processing_error. string
paramsEl parámetro al cual este error está relacionado. Puedes usar este error para subrayar campos de texto erróneos.string

Descripción de errores

TipoHTTP CodeDescripción
api_error500Error inesperado por parte de Conekta.
authentication_error401La llave usada en esta petición era inválida o no tiene permisos para ejecutar esta petición.
conflict_error409Se 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_error400El JSON del cuerpo de la petición era inválida o la codificación de caracteres en la petición es incorrecta.
parameter_validation_error422Algú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_error402Se 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_error404El 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.

MensajeDescripció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 devolución.
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.