> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Estados de las órdenes

> Qué significa cada valor de orderStatus para las órdenes fiat_to_crypto, crypto_to_fiat y fiat_to_fiat, y qué estados finalizan una orden.

`GET /v2/order/detail` y `GET /v2/orders` devuelven el estado de una orden en el campo entero `orderStatus`. Las órdenes de ramp (`fiat_to_crypto` y `crypto_to_fiat`) y las órdenes de pagos globales (`fiat_to_fiat`) usan dos conjuntos de códigos distintos.

> [!WARNING]
>
> Lee siempre `orderStatus` junto con `orderType`. Algunos códigos significan cosas distintas en los dos conjuntos: `71` es "Cancelando" en una orden de ramp, pero "Pago entrante cancelado" en una orden de pagos globales, y `72` es "Reembolsada" en una orden de ramp, pero "Pago saliente cancelado" en una orden de pagos globales.

## Órdenes de ramp (fiat\_to\_crypto, crypto\_to\_fiat)

| Código | Nombre | Significado | Finaliza la orden |
| - | - | - | - |
| `10` | En revisión | La orden está en revisión. | No |
| `11` | Revisión de riesgos | La orden está en revisión de riesgos. Puedes subir documentos de soporte con [Subir documentos](https://docs.velafi.com/es/api-reference/order/upload-invoice-documents-for-a-specific-order.md); después la orden pasa a `12`. | No |
| `12` | Documentos de RFI subidos | Se subieron documentos durante la revisión de riesgos y están en espera de una decisión. Si la revisión de riesgos rechaza la orden, pasa a `81` (o primero a `71`, ver abajo). | No |
| `31` | Documentos de soporte pendientes | Se requieren documentos de soporte. Después de subirlos con [Subir documentos](https://docs.velafi.com/es/api-reference/order/upload-invoice-documents-for-a-specific-order.md), la orden pasa a `40`. | No |
| `32` | En espera de depósito cripto | Solo `crypto_to_fiat`. La orden se aceptó aunque tu saldo cripto no la cubría (off-ramp con fondeo posterior). `GET /v2/order/detail` devuelve `orderExpireTimestamp` solo en este estado. La orden puede avanzar a `40` (o a `31` si se requieren documentos) solo si tu saldo la cubre antes de `orderExpireTimestamp`. | No |
| `40` | Pago pendiente | `fiat_to_crypto`: en espera del pago fiat. `crypto_to_fiat`: la cripto ya se tomó de tu saldo y el pago fiat está pendiente. | No |
| `50` | Pagada | El paso de pago terminó, pero la orden todavía no está completada. Para `crypto_to_fiat`, puedes completar la orden con [Confirmar orden](https://docs.velafi.com/es/api-reference/order/confirm-a-specific-order.md). Si no la confirmas, una orden en un canal de pago automatizado se completa automáticamente un tiempo después de que su pago sea exitoso. | No |
| `60` | Completada | La orden está completada. Una orden completada todavía puede reembolsarse, por ejemplo cuando su pago fiat es devuelto: entonces pasa a `73` (Reembolsando) y luego a `72`, o directamente a `72`. | Sí, a menos que después se reembolse |
| `70` | Cancelada | La orden fue cancelada. Las órdenes que expiraron sin pago también se devuelven como `70`. | Sí |
| `71` | Cancelando | La orden se está cancelando o rechazando, pero falló la devolución de la cripto de una orden `crypto_to_fiat`. Un proceso programado la termina. | No |
| `72` | Reembolsada | El reembolso está completo. | Sí |
| `73` | Reembolsando | Hay un reembolso en curso. | No |
| `80` | Rechazada | La orden fue rechazada en la revisión. Las órdenes cuya revisión expiró también se devuelven como `80`. | Sí |
| `81` | Rechazada en revisión de riesgos | La orden fue rechazada en la revisión de riesgos (desde `11` o `12`). | Sí |

Una orden nueva creada mediante la API normalmente empieza en `10`, `11`, `31`, `32` (solo `crypto_to_fiat`) o `40`. Para una orden `crypto_to_fiat`, si la cripto no se puede tomar de tu saldo cuando se crea la orden, la llamada de creación igual devuelve un `orderId`, pero la orden ya está en `70` (Cancelada) cuando la consultas.

> [!NOTE]
>
> `GET /v2/orders` lista todas las órdenes de tu cuenta para el `orderType` solicitado, no solo las órdenes que creaste mediante la API. Las órdenes que VelaFi crea para tu cuenta (no mediante la API ni el panel) también pueden mostrar `20` (revisión rechazada) o `30` (aprobada). Las órdenes creadas mediante la API se saltan estos dos códigos. Cuando se aprueban, normalmente pasan de `10` a `31`, `32` o `40`; si al momento de la aprobación el precio cayó por debajo del tipo de cambio mínimo de VelaFi, la orden se cancela en su lugar (`70`, o primero `71` como se describe arriba). Un rechazo en la revisión se reporta como `80` (o primero `71`, como se describe arriba).

### Cómo se reportan los estados internos

VelaFi almacena algunos estados internos que la API reporta con otro código. Nunca recibes `0`, `90`, `91` ni `92` para una orden de ramp:

| Estado interno | Se reporta como |
| - | - |
| `0` (inicializando) | `10` |
| `90` (revisión expirada) | `80` |
| `91` (sin pago, expirada) | `70` |
| `92` (saldo insuficiente, expirada) | `70` |

## Órdenes de pagos globales (fiat\_to\_fiat)

| Código | Nombre | Significado | Finaliza la orden |
| - | - | - | - |
| `10` | En revisión | La orden está en revisión. | No |
| `11` | Revisión de riesgos | La orden está en revisión de riesgos. Puedes subir documentos de soporte con [Subir documentos](https://docs.velafi.com/es/api-reference/order/upload-invoice-documents-for-a-specific-order.md); después la orden pasa a `12`. | No |
| `12` | Documentos de RFI subidos | Se subieron documentos durante la revisión de riesgos y están en espera de una decisión. | No |
| `31` | Documentos de soporte pendientes | Se requieren documentos de soporte y todavía no se ha subido ninguno. Después de subirlos, la orden vuelve a mostrar `41` o `51`. | No |
| `41` | Pago entrante pendiente | En espera del depósito fiat del remitente. | No |
| `51` | Pago saliente pendiente | El tramo de pago entrante está completo y el tramo de pago saliente está en curso. | No |
| `60` | Completada | El tramo de pago saliente está completo. | Sí |
| `71` | Pago entrante cancelado | El tramo de pago entrante fue cancelado. Las órdenes rechazadas en la revisión o cuya revisión expiró también se devuelven como `71`. | Sí |
| `72` | Pago saliente cancelado | El tramo de pago saliente fue cancelado. | Sí |
| `90` | Rechazada en revisión de riesgos | La orden fue rechazada en la revisión de riesgos. | Sí |

### Cómo se reportan los estados internos

Algunos estados internos se reportan con otro código:

| Estado interno | Se reporta como |
| - | - |
| `0` (inicializando) | `10` |
| `30` (aprobada) | `41`, o `31` si se requieren documentos y faltan |
| `40` (pago entrante recibido) | `51` |
| `41`, `51` | Sin cambios, o `31` si se requieren documentos y faltan |
| `73` (revisión expirada) | `71` |
| `90` (revisión rechazada) | `71` |
| `91` (revisión de riesgos rechazada) | `90` |

## Filtrar por estado

`GET /v2/orders` acepta un filtro `orderStatus`. `0` (el valor predeterminado) devuelve todos los estados.

* **Órdenes de ramp:** filtra por cualquier código de la tabla de ramp. `10`, `70` y `80` también coinciden con los estados internos que se reportan con ellos, así que los resultados coinciden con el `orderStatus` que ves.
* **Órdenes de pagos globales:** el filtro se aplica al estado almacenado, no al reportado. `10`, `11`, `12`, `60` y `72` coinciden exactamente. `41` y `51` también pueden devolver órdenes reportadas como `31`. Filtrar por `31`, `71` o `90` no devuelve exactamente las órdenes reportadas con ese código.

## Webhooks

Los payloads de los webhooks usan su propio mapeo de estados. Por ejemplo, las órdenes de ramp en `80` o `81` se envían como `70`. Consulta las páginas de webhooks, por ejemplo el [envío de órdenes fiat/cripto](https://docs.velafi.com/es/api-reference/webhooks/fiat-crypto-order-message-push.md), para ver los valores enviados.


## Related topics

- [Crear una orden de pago global](https://docs.velafi.com/es/api-reference/order/create-a-fiat-to-fiat-order.md)
- [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md)
- [Pagos globales (fiat a fiat)](https://docs.velafi.com/es/docs/guides/global-payments.md)
- [Listar órdenes](https://docs.velafi.com/es/api-reference/order/retrieve-a-list-of-orders.md)
- [Subir documentos de una orden](https://docs.velafi.com/es/api-reference/order/upload-invoice-documents-for-a-specific-order.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.