Empieza gratis
Español

Estados de un pago cripto: detectado, confirmando, pagado

Una factura cripto pasa por cuatro estados, y solo el último significa que te han pagado.

Un pago se crea, luego se ve, y luego queda enterrado bajo suficientes bloques para considerarse definitivo. Cada paso es un webhook distinto, porque cada uno significa algo diferente para tu sistema de pedidos.

La distancia entre «confirmando» y «pagado» es la que cuesta dinero. Una transacción incluida en un bloque no se ha deshecho, pero puede deshacerse si la cadena se reorganiza y ese bloque desaparece. Entregar con el pago en «confirmando» es entregar contra una transacción que todavía puede esfumarse.

El ciclo, en orden

  1. invoice.created — La factura existe y tiene una dirección de recepción reservada. No se ha enviado nada.
  2. invoice.receiving — Se ha visto un pago en la red pero aún no está en un bloque.
  3. invoice.confirming — El pago está en un bloque y acumula confirmaciones. No es definitivo.
  4. invoice.paid — El pago alcanzó el umbral de confirmaciones de su red. Es el único estado que significa pagado.

Los estados que no son «pagado»

  • invoice.underpaid — Llegó menos de lo que pedía la factura. Los pagos siguientes se acumulan.
  • invoice.overpaid — Llegó más de lo que pedía la factura. El excedente ya está en tu dirección.
  • invoice.expired — La ventana se cerró antes de que llegara el pago.

Preguntas frecuentes

¿Qué significa «confirmando» en una factura cripto?

Significa que el pago se ha visto en la cadena pero aún no está enterrado bajo suficientes bloques para darlo por definitivo. El dinero es real y visible; la garantía de que no puede deshacerse todavía se está ganando.

¿Cuándo es seguro entregar el pedido?

Solo cuando la factura marca pagado. Detectado y confirmando describen un pago que existe y aún podría revertirse, que es justo la ventana de la que vive un pagador fraudulento.

¿Qué pasa si un pago nunca llega a pagado?

La factura caduca y el pedido no se completa, pero lo que sí llegó ya está en tu propia dirección. La liquidación directa hace que una factura inacabada nunca deje tu dinero fuera de tu alcance.

Siguiente

Desarrolladores

Empieza gratis