Estados de pago

Los 11 estados

Código	Nombre	Descripción	Terminal
NR	Not Ready	Orden creada sin input_currency asignada.	No
PE	Pending	Esperando que el cliente pague.	No
AC	Awaiting Completion	Pago recibido, esperando confirmación blockchain. Verifique safe.	No
IA	Insufficient Amount	Importe recibido menor que el esperado.	Sí
CO	Completed	Pago exitoso, confirmado en blockchain. Libere producto.	Sí
CM	Completed by Merchant	Completado manualmente por el merchant.	Sí
CA	Cancelled	Expiración superior a 24 h sin pago.	Sí
EX	Expired	Sin recepción en 15 o 60 minutos según red.	Sí
OC	Out of Condition	Precio cambió desfavorablemente; recibido no cubre el importe.	Sí
FA	Failed	Transacción no confirmada o rechazada.	Sí
DE	Deleted	Orden eliminada.	Sí

El campo safe

Cuando una orden está en AC, el campo booleano safe indica si el pago ya tiene una confirmación blockchain y es seguro liberar producto/servicio.

• safe: false → aún mempool / 0 confirmaciones. No libere.
• safe: true → pago estable, libere.

Diagrama de estados

stateDiagram-v2
    [*] --> NR: orden creada sin input_currency
    [*] --> PE: orden creada con input_currency
    NR --> PE: cliente elige moneda
    PE --> AC: se detecta pago en mempool
    PE --> EX: timeout sin recepción (15/60 min)
    PE --> CA: expiración >24h
    AC --> CO: confirmación blockchain
    AC --> OC: importe menor que esperado
    AC --> IA: importe insuficiente
    AC --> FA: fallo de confirmación
    CO --> [*]
    CA --> [*]
    EX --> [*]
    OC --> [*]
    IA --> [*]
    FA --> [*]
    DE --> [*]
    CM --> [*]

Mapeo a estados típicos de merchant

B4bit Pay expone 11 estados granulares, pero la mayoría de merchants solo necesitan ≤4. Mapping recomendado:

Estado B4bit Pay	Estado merchant
NR · PE · AC(safe=false)	Pending
CO · AC(safe=true) · CM	Processing (o Paid)
CA · EX	Cancelled
FA · OC · IA	Failed
DE	Deleted

Timeouts

• EX (Expired): se dispara tras 15 o 60 minutos sin recepción, dependiente de la moneda y la red.
• CA (Cancelled): tras 24 horas sin pago.

Consejo

Para saber cuándo expira un pago, consulte el campo expired_time del schema Payment (formato ISO 8601).

Qué estados disparan webhook

Todos los cambios de estado generan un webhook, excepto IA (insufficient amount) que algunas veces se consolida con el siguiente cambio. Si necesita reaccionar a IA, haga polling con GET /orders/info/{identifier} o asuma que el siguiente webhook trae el estado definitivo.

Ver webhook y webhook-ordering.