RugWard Pay
Factures, liens de paiement et paiements de test
Créez des factures dans le tableau de bord, partagez des liens et boutons de paiement réutilisables, testez gratuitement tout le parcours de paiement sur un testnet et gérez les paiements non rapprochés.
Sur cette page
Créer une facture#
Dans le tableau de bord, remplissez New invoice et cliquez sur Create invoice. Vous obtenez un lien de paiement à envoyer à votre acheteur (https://rugward.com/pay/i/<id>).
| Champ | Règles | Remarques |
|---|---|---|
| ① Amount (USD) | de 1 $ à 50 000 $, 2 décimales max. (25 ou 25.50) | L'acheteur paie l'équivalent dans la crypto qu'il choisit. |
| ② Expires after | 30 minutes, 1 heure (par défaut), 3 heures, 1 jour ou 7 jours dans le tableau de bord ; de 15 minutes à 7 jours avec l'API | Après expiration, la page de paiement indique « Do not send anything » et aucun nouveau taux ne peut être bloqué. |
| ③ Order id (facultatif) | jusqu'à 64 caractères : lettres, chiffres et . _ - : # / | Votre propre référence ; renvoyée dans l'API et les webhooks. |
| ④ Return URL (facultatif) | adresse https:// complète | Montrée à l'acheteur uniquement après le paiement de la facture, sous forme de bouton « Return to <votre site> ». |
| Description (facultatif) | jusqu'à 200 caractères | Affichée à l'acheteur, par exemple « 1 × T-shirt, taille M ». |
L'acheteur choisit la crypto sur la page de paiement. Le taux est bloqué 30 minutes à partir de ce moment (et non de la création de la facture), donc une longue durée de vie de facture ne vous expose pas aux variations de prix.
N'expédiez qu'une fois que le tableau de bord (ou le webhook invoice.paid) indique Paid. Un acheteur qui arrive sur votre URL de retour n'est pas une preuve de paiement : n'importe qui peut ouvrir une URL.
Liste et détails des factures#
Invoices affiche vos dernières factures avec la date, le montant, le numéro de commande et le statut. Details ouvre une facture : les cotations (crypto, montant, taux, adresse), chaque paiement vu on-chain avec ses confirmations et son lien d'explorateur, et les boutons Open checkout, Payment proof (factures payées) et Cancel invoice.
Libellés de statut que vous verrez :
| Libellé | Statut API |
|---|---|
| Awaiting payment (en attente de paiement) | open |
| Payment detected, confirming (paiement détecté, confirmation en cours) | pending |
| Paid (payée) | paid |
| Paid (more than requested) (surpayée) | overpaid |
| Underpaid (sous-payée) | underpaid |
| Paid after expiry (payée après expiration) | late |
| Expired (expirée) | expired |
| Canceled (annulée) | canceled |
Ce que chacun signifie et que faire : Statuts, confirmations et preuves.
Annuler une facture#
Vous pouvez annuler votre propre facture tant qu'elle est open et qu'aucun paiement n'a été vu. La page de paiement indique alors à l'acheteur « The merchant canceled this invoice. Do not send anything to it. » Webhook : invoice.canceled. Une facture avec un paiement en cours ne peut pas être annulée (409).
Liens et boutons de paiement#
Un lien de paiement est un lien réutilisable à prix fixe : un produit, un don, un abonnement mensuel. Chaque acheteur qui clique sur Pay with crypto reçoit sa propre facture neuve (valable 60 minutes), donc les paiements ne se mélangent jamais.
- Saisissez le montant en USD, une description et une URL de retour facultative, puis Create link.
- Le tableau de bord affiche la vue acheteur (exactement ce que voient les acheteurs), le lien
https://rugward.com/pay/l/<id>et son nombre d'utilisations. - Copy link pour le partager dans une discussion, un e-mail ou sur les réseaux sociaux, ou Copy button HTML pour placer un bouton « Pay with crypto » sur votre site.
- Turn off désactive le lien. Les factures déjà créées à partir de celui-ci ne sont pas affectées.
Le bouton est un simple lien HTML. Il ne charge aucun script et ne dépose aucun cookie :
<a href="https://rugward.com/pay/l/k33JZ0ij5F2yLDprwrQgjN" target="_blank" rel="noopener"
style="display:inline-block;padding:10px 20px;border-radius:12px;background:#f0b90b;color:#000;font:600 15px system-ui,sans-serif;text-decoration:none">Pay with crypto</a>
Bon à savoir :
- Les factures créées depuis un lien portent le numéro de commande
link:<8 premiers caractères de l'id du lien>, pour les distinguer dans la liste, l'API et les webhooks. - Limites : 100 liens actifs par marchand ; un lien crée au maximum 100 factures par heure (ce qui protège votre quota horaire de factures contre les abus). L'ouverture d'un lien est protégée par Cloudflare Turnstile si nécessaire.
Factures de test (gratuites, testnet Sepolia)#
Ouvrez Test invoice (Sepolia testnet) dans le tableau de bord pour essayer tout le parcours de paiement sans argent réel. L'acheteur paie avec de l'ETH de test Sepolia ou l'USDC de test Sepolia de Circle via le splitter RugWard Pay déployé sur Sepolia, qui envoie 99,5 % à l'adresse de réception et 0,5 % au portefeuille de frais de RugWard, exactement comme sur Base.
- Montant : de 1 $ à 100 $. Adresse de réception de test facultative (une adresse EVM) ; sinon votre adresse EVM est utilisée.
- Les cryptos de test n'ont aucune valeur. Elles sont gratuites : de l'ETH Sepolia via un faucet (par exemple le faucet Sepolia de Google Cloud) et de l'USDC de test via le faucet de Circle (choisissez Ethereum Sepolia).
- Les factures de test sont marquées TEST sur la page de paiement, dans la liste et sur la preuve ; elles n'appellent jamais votre webhook et ne peuvent pas être créées avec une clé API, donc un test ne peut jamais déclencher l'expédition d'une vraie commande.
Paiements non rapprochés#
Il arrive qu'un transfert atteigne votre adresse sans correspondre exactement à une facture : un mauvais montant, un paiement envoyé bien après l'expiration ou un transfert sans rapport. RugWard ne les marque jamais automatiquement comme payés. S'il y en a, le tableau de bord affiche un encadré Unmatched payments avec le montant, le réseau, le lien de la transaction et la facture qui était vérifiée au moment où il a été vu.
Que faire : ouvrez la transaction, contactez l'acheteur et réglez la situation vous-même (livrez, ou renvoyez l'argent depuis votre portefeuille). Cliquez ensuite sur Dismiss.
Dernière mise à jour: 30 octobre 2026