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 detailsen 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.