Referencias
Estados de un depósito
Los cinco valores de status, qué significa cada uno y qué evento lo acompaña.
status | Significado | Evento | ¿Acreditar? | breakdown |
|---|---|---|---|---|
statusdetected | SignificadoLa transferencia se vio en la red; faltan los bloques de espera. | Eventodeposit.detected | ¿Acreditar?No | breakdownnull |
statusconfirmed | SignificadoFirme y por encima del mínimo. Pendiente de barrer. | Eventodeposit.confirmed | ¿Acreditar?Sí | breakdownCotizado (final: false) |
statussettled | SignificadoBarrido: el dinero ya está en la tesorería. | Eventodeposit.settled | ¿Acreditar?Ya acreditado en confirmed | breakdownDefinitivo (final: true) |
statusbelow_minimum | SignificadoConfirmado, pero menor que el mínimo o no cubre comisiones y gas. | Eventodeposit.below_minimum | ¿Acreditar?No | breakdownCotizado (final: false) |
statusreverted | SignificadoLa transferencia desapareció de la red antes de confirmarse. | Eventodeposit.reverted | ¿Acreditar?No | breakdownnull |
Transiciones#
detected ──► confirmed ──────► settled
│
├──────► below_minimum ──► settled (cuando se barre junto con un depósito válido posterior)
│
└──────► revertedrevertedsolo se alcanza desdedetected. Un depósitoconfirmedno se anula.settledes final.revertedtambién.- Un depósito
below_minimumpuede quedarse así indefinidamente si el cliente no vuelve a depositar ese token. - Si el
adminde la empresa barre antes de la confirmación, el depósito pasa dedetectedasettledy se emitendeposit.confirmedydeposit.settledseguidos.
Sobre settled#
settled no se guarda como un estado aparte: es un depósito confirmed (o below_minimum) cuyo barrido ya terminó. Para ti es un estado más, pero explica dos comportamientos de los filtros:
status=confirmeden Listar depósitos devuelve solo los confirmados que aún no se han barrido. Normalmente son muy pocos, porque el barrido tarda segundos.- En Ver resumen,
totalscuenta los depósitos acreditados, estén liquidados o no;by_statuslos separa.
Estados de un envío de webhook#
delivery.status | Significado |
|---|---|
delivery.statuspending | SignificadoEn cola o esperando el siguiente reintento (next_attempt_at). |
delivery.statusdelivered | SignificadoTu servidor respondió 2xx. |
delivery.statusdead | SignificadoSe agotaron los 13 intentos. Se puede reenviar a mano. |