Estados de um pagamento cripto: detetado, a confirmar, pago

Uma fatura cripto passa por quatro estados, e só o último significa que foi pago.

Um pagamento é criado, depois visto, e depois enterrado sob blocos suficientes para ser considerado definitivo. Cada passo é um webhook distinto, porque cada um significa algo diferente para o seu sistema de encomendas.

É a distância entre «a confirmar» e «pago» que custa dinheiro. Uma transação já incluída num bloco não foi desfeita — mas pode ser, se a cadeia se reorganizar e esse bloco cair. Entregar com o pagamento ainda a confirmar é entregar contra uma transação que ainda pode desaparecer.

O ciclo, por ordem

invoice.created — A fatura existe e tem um endereço de receção reservado. Nada foi enviado.
invoice.receiving — Um pagamento foi visto na rede mas ainda não está num bloco.
invoice.confirming — O pagamento está num bloco e a acumular confirmações. Não é definitivo.
invoice.paid — O pagamento atingiu o limiar de confirmações da sua rede. É o único estado que significa pago.

Os estados que não são «pago»

invoice.underpaid — Chegou menos do que a fatura pedia. Os pagamentos seguintes acumulam-se.
invoice.overpaid — Chegou mais do que a fatura pedia. O excedente já está no seu endereço.
invoice.expired — A janela fechou antes de o pagamento chegar.

Perguntas frequentes

O que significa “a confirmar” numa fatura em cripto?

Significa que o pagamento foi visto na cadeia mas ainda não está coberto por blocos suficientes para ser tratado como definitivo. O dinheiro é real e visível; a garantia de que não pode ser desfeito ainda está a ser ganha.

Quando é seguro entregar a encomenda?

Apenas quando a fatura indica pago. Detetado e a confirmar descrevem um pagamento que existe e ainda pode ser revertido, que é exatamente a janela de que vive um pagador fraudulento.

O que acontece se um pagamento nunca chegar a pago?

A fatura expira e a encomenda não se conclui, mas o que chegou já está no seu próprio endereço. A liquidação direta faz com que uma fatura por terminar nunca deixe o seu dinheiro fora do seu alcance.

A seguir

Desenvolvedores

Começar grátis