Estados del retiro

Estados del retiro

Estado	Descripción	Final
created	El retiro está creado y todavía no ha salido a la red	No
signed	La transacción está firmada y enviada a la blockchain	No
cancelling	El retiro se está cancelando; cómo acaba lo dirá el siguiente estado	No
completed	La transacción está confirmada en cadena y el dinero, entregado	Sí
failed	El retiro no llegó a salir. El importe volvió al saldo	Sí
cancelled	El comercio canceló el retiro y no salió. El importe volvió al saldo	Sí
pending_review	La transacción aún no está confirmada en la red y el importe sigue retenido. En el panel este estado aparece como «Sin confirmar»	No

Cómo leer esto desde el código

Hay tres estados finales: completed, failed y cancelled. Cada respuesta y cada webhook llevan el campo is_final; ramifica por él y no por una lista de nombres que tendrías que mantener tú.

Un retiro solo se puede cancelar mientras está en created. Después, la petición de cancelación se rechaza; ver Cancelar un retiro. El motivo por el que un retiro no salió no lo devuelve la API: failed tiene estado, pero no un campo que lo explique.

En sandbox, POST /v1/sandbox/withdrawals/{id}/simulate-completion lleva un retiro de created a completed, sin firma y sin cadena.