Referencias

Estados de un depósito

Los cinco valores de status, qué significa cada uno y qué evento lo acompaña.


statusSignificadoEvento¿Acreditar?breakdown
statusdetectedSignificadoLa transferencia se vio en la red; faltan los bloques de espera.Eventodeposit.detected¿Acreditar?Nobreakdownnull
statusconfirmedSignificadoFirme y por encima del mínimo. Pendiente de barrer.Eventodeposit.confirmed¿Acreditar?SíbreakdownCotizado (final: false)
statussettledSignificadoBarrido: el dinero ya está en la tesorería.Eventodeposit.settled¿Acreditar?Ya acreditado en confirmedbreakdownDefinitivo (final: true)
statusbelow_minimumSignificadoConfirmado, pero menor que el mínimo o no cubre comisiones y gas.Eventodeposit.below_minimum¿Acreditar?NobreakdownCotizado (final: false)
statusrevertedSignificadoLa transferencia desapareció de la red antes de confirmarse.Eventodeposit.reverted¿Acreditar?Nobreakdownnull

Transiciones#

Estados
detected ──► confirmed ──────► settled
   │
   ├──────► below_minimum ──► settled   (cuando se barre junto con un depósito válido posterior)
   │
   └──────► reverted
  • reverted solo se alcanza desde detected. Un depósito confirmed no se anula.
  • settled es final. reverted también.
  • Un depósito below_minimum puede quedarse así indefinidamente si el cliente no vuelve a depositar ese token.
  • Si el admin de la empresa barre antes de la confirmación, el depósito pasa de detected a settled y se emiten deposit.confirmed y deposit.settled seguidos.

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=confirmed en 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, totals cuenta los depósitos acreditados, estén liquidados o no; by_status los separa.

Estados de un envío de webhook#

delivery.statusSignificado
delivery.statuspendingSignificadoEn cola o esperando el siguiente reintento (next_attempt_at).
delivery.statusdeliveredSignificadoTu servidor respondió 2xx.
delivery.statusdeadSignificadoSe agotaron los 13 intentos. Se puede reenviar a mano.