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. |
Updated 5 months ago