---
updatedAt: 2025-09-22T21:32:44.000Z
agentTools:
  projectIndex: https://developers.digitalfemsa.io/llms.txt
---

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

## 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 Oxxo Pay.                                                                                                                                    |
| 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.       |