États d’un paiement crypto : détecté, en confirmation, payé

Une facture crypto traverse quatre états, et seul le dernier signifie que vous avez été payé.

Un paiement est créé, puis vu, puis enfoui sous assez de blocs pour être considéré comme définitif. Chaque étape est un webhook distinct, parce que chacune signifie autre chose pour votre système de commandes.

C’est l’écart entre « en confirmation » et « payé » qui coûte de l’argent. Une transaction inscrite dans un bloc n’a pas été annulée — mais elle peut l’être si la chaîne se réorganise et que ce bloc disparaît. Livrer sur un paiement en confirmation, c’est livrer contre une transaction qui peut encore s’effacer.

Le cycle de vie, dans l’ordre

invoice.created — La facture existe et une adresse de réception lui est réservée. Rien n’a été envoyé.
invoice.receiving — Un paiement a été vu sur le réseau mais n’est pas encore dans un bloc.
invoice.confirming — Le paiement est dans un bloc et accumule des confirmations. Il n’est pas définitif.
invoice.paid — Le paiement a atteint le seuil de confirmations de son réseau. C’est le seul état qui signifie payé.

Les états qui ne veulent pas dire « payé »

invoice.underpaid — Moins que demandé est arrivé. Les paiements suivants s’y ajoutent.
invoice.overpaid — Plus que demandé est arrivé. L’excédent est déjà sur votre adresse.
invoice.expired — La fenêtre s’est fermée avant l’arrivée du paiement.

Questions fréquentes

Que signifie « en confirmation » sur une facture crypto ?

Le paiement a été vu sur la chaîne mais n’est pas encore recouvert d’assez de blocs pour être tenu pour définitif. L’argent est réel et visible ; la garantie qu’il ne peut plus être annulé est encore en train de se construire.

Quand peut-on livrer sans risque ?

Uniquement lorsque la facture indique payé. Détecté et en confirmation décrivent tous deux un paiement qui existe et pourrait encore être annulé — précisément la fenêtre dont vit un payeur frauduleux.

Que se passe-t-il si un paiement n’atteint jamais l’état payé ?

La facture expire et la commande n’aboutit pas, mais tout ce qui est arrivé se trouve déjà sur votre propre adresse. Le règlement direct fait qu’une facture inachevée ne laisse jamais votre argent hors de portée.

Suite

Développeurs

Commencer gratuitement