Statuts, confirmations et preuves de paiement

Le cycle de vie en un coup d'œil#

open ──(payment seen)──▶ pending ──(enough confirmations, full amount)──▶ paid / overpaid
  │                        │
  │                        └─(quote expired + 10 min grace, still short)──▶ underpaid
  ├─(nothing arrives before expiry)──▶ expired
  ├─(payment seen only after quote expiry + 10 min)──▶ late
  └─(merchant cancels, no payment yet)──▶ canceled

Référence des statuts#

Chaque changement de statut crée un événement webhook (invoice.pending, invoice.paid, …). Voir Webhooks.

Quand une facture compte-t-elle comme payée ?#

Pour la crypto choisie par l'acheteur, RugWard additionne les paiements confirmés vus avant l'expiration de la cotation plus 10 minutes de grâce (ainsi, une transaction diffusée juste avant l'échéance compte encore). La facture est :

• paid lorsque ce total atteint au moins le montant coté moins une petite tolérance : le décalage du montant unique plus 0,1 % (couvre les portefeuilles qui arrondissent les derniers chiffres) ;
• overpaid lorsqu'il dépasse de plus de 1 % le montant coté.

Les montants dans des cryptos différentes ne sont jamais additionnés. Sur Base, où les 0,5 % sont répartis on-chain, la vérification porte sur les 99,5 % qui vous parviennent.

Confirmations#

Comment RugWard détecte les paiements#

Protections intégrées à la détection :

• Une transaction paie une facture. Une transaction ne peut être créditée qu'une seule fois par réseau et par adresse de destination.
• Pas de front-running. Un hash de transaction collé par quelqu'un d'autre n'est accepté que s'il correspond au montant unique exact de cette cotation ou porte sa reference.
• Pas d'anciennes transactions. Une transaction minée avant la création de la cotation ne peut pas la payer.
• Une transaction collée avec un montant différent est refusée avec « Contact the merchant with the transaction id » ; le marchand règle la situation manuellement.
• Le taux est calculé uniquement sur le serveur ; le navigateur de l'acheteur ne fournit jamais de prix.

Remboursements#

RugWard Pay est non dépositaire : l'argent est déjà dans votre portefeuille, donc RugWard ne peut ni rembourser, ni annuler, ni rétrofacturer quoi que ce soit. Pour rembourser un acheteur, renvoyez vous-même les cryptos depuis votre portefeuille, idéalement vers une adresse que l'acheteur vous indique (pas automatiquement vers l'adresse d'envoi : elle peut appartenir à une plateforme d'échange). Conservez l'identifiant de facture et les liens des transactions pour vos archives.

Preuves de paiement#

Chaque facture paid ou overpaid dispose d'une page de preuve publique et partageable à https://rugward.com/pay/proof/<invoice id> (également en JSON à /api/pay/proof/<invoice id>). Elle affiche le montant en USD, le marchand, la date de confirmation, le montant en crypto coté et le taux avec ses sources de prix, l'adresse de réception et chaque transaction confirmée avec un lien d'explorateur. N'importe qui peut revérifier ces transactions sur la blockchain publique.

Les pages de preuve ne sont pas indexées par les moteurs de recherche. Les factures impayées n'ont pas de preuve (404).

L'expiration en détail#

• Expiration de la facture (de 15 minutes à 7 jours) : après, aucun nouveau taux ne peut être bloqué.
• Expiration de la cotation (blocage du taux) : 30 minutes après le choix d'une crypto par l'acheteur. S'il reste moins de 5 minutes, choisir à nouveau la même crypto bloque un nouveau taux.
• Grâce : les paiements vus jusqu'à 10 minutes après l'expiration de la cotation comptent normalement.
• Une facture ne passe à expired qu'une fois que la facture et sa dernière cotation (plus la grâce) ont toutes deux pris fin sans paiement.