Confirmaciones

El número de bloques que una red registró desde el bloque que contiene una transferencia, incluido ese bloque. Cada bloque nuevo hace más difícil revertir esa transferencia.

#Cómo funciona en CryptoLike

CryptoLike fija un umbral de confirmaciones para cada activo de su catálogo. GET /v1/currencies lo devuelve en el campo confirmations de cada activo, y la página de monedas compatibles muestra el mismo valor. Un pago pasa a paid y los fondos se acreditan a tu saldo solo cuando su transferencia alcanza ese umbral en su red.

Mientras la transferencia está por debajo del umbral, el pago está en pending. La página de pago dice «Pago detectado. Esperando confirmación.» y muestra confirmations.current de confirmations.required, normalmente con una estimación en minutos. Recibes invoice.pending cuando la transferencia se detecta por primera vez e invoice.paid cuando se confirma. Los depósitos a una dirección estática siguen la misma regla: primero deposit.pending, luego deposit.confirmed (o deposit.on_hold si una revisión de cumplimiento retiene los fondos), con confirmations y required_confirmations en el objeto deposit.

Si una reorganización de la blockchain revierte una transferencia confirmada, CryptoLike recalcula el pago y envía invoice.reverted (deposit.reverted para una dirección estática). Entrega el pedido con paid, detén la entrega con reverted y espera un nuevo invoice.paid; qué hace una reorganización antes y después del umbral se explica en por qué «detectado» no es «pagado». Los retiros también cuentan confirmaciones: un retiro en broadcast pasa a completed cuando se cumple el requisito del activo. Más detalles: cuántas confirmaciones necesita un pago cripto.

#Ejemplo

El catálogo público de CryptoLike lista cada activo con su red, sus decimales y su umbral de confirmaciones: los mismos números que la página de pago le muestra al cliente. Consúltalo antes de construir un flujo de pedidos que dependa de los tiempos, y no le prometas al cliente un tiempo exacto: los bloques llegan al ritmo de la red. La solicitud sin firma devuelve el catálogo público:

curl -s https://api.cryptolike.net/v1/currencies