Estados de las órdenes

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.

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; 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, 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. 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.

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; 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, para ver los valores enviados.

Primeros pasos

Conceptos clave

Guías

Referencia

Estados de las órdenes

Órdenes de ramp (fiat_to_crypto, crypto_to_fiat)

Cómo se reportan los estados internos

Órdenes de pagos globales (fiat_to_fiat)

Cómo se reportan los estados internos

Filtrar por estado

Webhooks

​Órdenes de ramp (fiat_to_crypto, crypto_to_fiat)

​Cómo se reportan los estados internos

​Órdenes de pagos globales (fiat_to_fiat)

​Cómo se reportan los estados internos

​Filtrar por estado

​Webhooks

Órdenes de ramp (fiat_to_crypto, crypto_to_fiat)

Cómo se reportan los estados internos

Órdenes de pagos globales (fiat_to_fiat)

Cómo se reportan los estados internos

Filtrar por estado

Webhooks