← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

Paiements crypto récurrents : les créer et les gérer

Paiements crypto récurrents : escrow, prélèvements signés et facturation à adresse statique comparés, avec standards d'allowance, webhooks et 1099-DA.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

Illustration isométrique de l'architecture de paiement récurrent

Les paiements crypto récurrents sont une facturation de type abonnement : un client paie un marchand en cryptomonnaie selon un calendrier. Les blockchains n’ont pas de fonction d’abonnement native. On la construit avec un paiement vers une adresse statique, un contrat d’escrow préalimenté ou un prélèvement signé. Les stablecoins sont l’actif habituel, car une facture exige une valeur stable.

Quel modèle devez-vous construire ?

Le guide de Stripe sur les paiements crypto récurrents décrit les principaux modèles. Comme beaucoup de blockchains ne gèrent pas de minuteurs natifs, les paiements récurrents reposent sur des déclencheurs offchain et des couches d’automatisation. Le guide cite Chainlink Automation et Gelato pour déclencher l’exécution des contrats, ainsi que Superfluid et Sablier pour les flux de paiement continus.

ModèleQui déclenche le paiementOù se trouvent les fondsCe qu’il vous faut
Facturation à adresse statiqueLe client, à chaque périodeChez le client jusqu’au paiementUne adresse par client, un webhook, la réconciliation
Escrow prépayéUn planificateur ou le contratDans un smart contractUn contrat, un déclencheur offchain, un audit
Paiements pull signésLe marchand, à chaque cycleChez le client jusqu’au prélèvementUn contrat qui vérifie les signatures, un planificateur
StreamingLe contrat, en continuDans un contrat de streamingUn contrat, le regroupement des règlements

La facturation à adresse statique n’a pas besoin de contrat et reste la plus simple à exploiter. Chaingateway facture ainsi ses propres abonnements : chaque client a une adresse de paiement statique, le montant est libre, et la date de fin de l’abonnement se déplace selon le montant reçu. La version New Payment Flow le décrit. Le revers : le client doit agir à chaque période, donc le renouvellement dépend d’un rappel et non d’une automatisation.

L’escrow et les paiements pull suppriment cette étape manuelle. Ils apportent aussi un risque de contrat, une exigence de disponibilité du planificateur et, pour les prélèvements, la question de la manière dont le client révoque la permission.

Comment fonctionne la facturation à adresse statique avec des webhooks ?

Vous créez une adresse par client, vous enregistrez un webhook pour elle, et vous créditez l’abonnement quand un paiement correspondant arrive. Le webhook ci-dessous surveille une adresse Tron pour de l’USDT. Le champ reference porte l’identifiant de votre abonnement, ce qui permet de rattacher la notification au compte :

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"type": "TRC20",
"url": "https://billing.example.com/hooks/payment",
"reference": "sub_20417"
}'

Une notification contient txid, from, to, contractaddress, amount, blocknumber et webhook_id. Votre gestionnaire doit faire cinq choses :

  1. Vérifier l’en-tête X-Signature, qui signe le txid une fois que vous avez défini un secret personnel.
  2. Retrouver l’abonnement grâce au webhook_id ou à l’adresse.
  3. Rejeter un txid déjà vu.
  4. Comparer amount et le token avec la facture, et décider quoi faire des paiements insuffisants, des paiements en trop et des mauvais tokens.
  5. Prolonger la période d’abonnement et répondre avec un statut 2xx.

Vérifiez l’unité de amount avec un paiement sur testnet avant d’écrire la logique de tarification. Les webhooks ne sont pas renvoyés automatiquement. Une notification échouée apparaît dans GET /api/v2/tron/webhooks/notifications/failed, et vous la renvoyez avec l’endpoint de nouvelle tentative. Une tâche de nuit qui compare les paiements attendus et reçus rattrape le reste. Le guide des webhooks détaille l’idempotence et les tests.

Quel token et quel réseau choisir ?

Utilisez un stablecoin majeur et choisissez le réseau selon les frais et selon l’endroit où vos clients détiennent déjà leurs fonds. Une facture mensuelle de 29 $ doit encore valoir environ 29 $ à son règlement. Si vous acceptez un jour un actif volatil, convertissez-le à la réception et enregistrez la conversion séparément de la facture.

Les réseaux de couche 2 existent pour faire monter Ethereum en charge, et ethereum.org cite les frais bas parmi leurs avantages. Selon la documentation de Tron, Tron héberge le plus grand réseau d’USDT TRC-20. Chaingateway prend en charge Ethereum, Arbitrum, Polygon, BNB Smart Chain et Tron, entre autres, pour cet usage. Chaque réseau a son propre modèle de frais : testez d’abord un paiement complet et un remboursement sur le testnet du réseau, avec l’en-tête X-Network: testnet.

Que changent les standards d’allowance pour les paiements pull ?

Ils limitent la durée et le montant qu’un contrat marchand peut prélever. Une approbation ERC-20 classique peut être illimitée et permanente : un contrat marchand compromis peut alors vider tout le solde du client. Trois standards traitent une partie du problème. Leur statut diffère, vérifiez-le avant de dépendre de l’un d’eux :

StandardCe qu’il ajouteStatut dans le dépôt EIP (5 novembre 2026)
ERC-2612Permit : approbations par message signé, sans transaction d’approbation séparéeFinal
ERC-5827Extension d’allowance à renouvellement automatiqueStagnant
ERC-8255Approbations de tokens expirantes : par défaut, les approbations expirent après une durée bornéeDraft

Seul un token qui implémente un standard le prend en charge. Vérifiez chaque token que vous acceptez, et concevez le contrat pour qu’il fonctionne aussi avec une approbation classique d’un montant borné. Demandez au client un montant qui couvre quelques cycles plutôt qu’une approbation illimitée.

Comment sécuriser la facturation récurrente ?

Considérez la révocation, les clés et les webhooks comme les trois risques. Révocation : si un client révoque une allowance, votre système doit l’apprendre avant l’échec du prélèvement suivant, donc surveillez les événements d’approbation pour votre adresse de spender. Clés : utilisez un portefeuille multisig pour les fonds de trésorerie et gardez les clés du planificateur séparées de celles qui peuvent atteindre la trésorerie. Webhooks : vérifiez chaque signature et dédupliquez, comme dans la section ci-dessus.

Les clients peuvent aussi être visés par des usurpations d’identité. Publiez vos adresses de paiement sur une seule page statique et dites aux clients de ne jamais envoyer de fonds vers une adresse reçue dans un e-mail ou un message de chat. Les flux de facturation légitimes affichent l’adresse dans votre propre application.

Quelles règles de déclaration fiscale faut-il connaître ?

L’IRS américain exige des courtiers qu’ils déclarent les ventes d’actifs numériques sur le formulaire 1099-DA, ce qui peut inclure certains processeurs de paiement. La page sur les actifs numériques de l’IRS indique que la déclaration s’applique aux transactions à partir du 1er janvier 2025 et que la réglementation entre en vigueur progressivement. Elle range les processeurs de paiements en actifs numériques (PDAP) parmi les courtiers concernés, et elle s’applique aux courtiers qui prennent possession des actifs vendus. Savoir si votre service compte comme courtier dépend de la garde et du flux des fonds : demandez conseil à un conseiller fiscal. Cet article ne constitue pas un conseil fiscal ou juridique.

Pour la comptabilité, enregistrez trois montants pour chaque paiement : le montant de la facture dans la devise de facturation, le montant crypto reçu, et la valeur dans votre devise de déclaration au moment de la réception. Conservez l’identifiant de transaction avec chaque enregistrement.

À quoi ressemble un pilote raisonnable ?

Commencez avec un réseau, un stablecoin et un groupe de clients. Construisez d’abord la facturation à adresse statique, car c’est celle qui a le moins de pièces mobiles. Mesurez deux chiffres dès le premier paiement : la part des factures payées à temps, et les minutes de réconciliation manuelle par cycle. N’ajoutez l’escrow ou les paiements pull que si l’étape de renouvellement manuel vous fait perdre des clients.

Vous pouvez créer les adresses, les webhooks et les paiements sortants de ce pilote avec la Blockchain API et les Chaingateway Webhooks. Le fichier OpenAPI ne contient aucun endpoint pour les approbations, la planification ou les appels de contrat arbitraires : les paiements pull et l’escrow demandent donc votre propre contrat et votre propre planificateur. Les plans démarrent à 49 € par mois, et l’essai gratuit de 7 jours ne demande ni carte ni KYC. Voir la page des tarifs.

Sources

Recommandé

Questions fréquentes

L’IRS ne surveille pas directement les portefeuilles. Il reçoit les déclarations des courtiers qui déposent le formulaire 1099-DA pour les transactions d’actifs numériques à partir de 2025. Si votre entreprise ou une plateforme que vous utilisez est qualifiée de courtier, vos transactions apparaissent dans ces déclarations.

Les clients doivent soit agir à chaque période, soit accorder une permission qu’un contrat peut utiliser. Les frais de gas varient selon le réseau, et les tokens autres que les stablecoins comportent un risque de prix. Le travail fiscal et de conformité ajoute une charge, en particulier pour les processeurs.

Un flux de facturation récurrente légitime ne vous demande jamais d’envoyer des fonds manuellement vers une adresse reçue dans un e-mail ou un message de chat. Comparez toute adresse avec celle publiée sur le site du marchand avant de payer ou d’approuver quoi que ce soit.

Cela dépend du client. La facturation à adresse statique avec webhooks est la plus simple à exploiter et n’a pas besoin de contrat. Les paiements pull conviennent aux clients qui veulent de l’automatisation, et ils demandent un contrat audité et un planificateur.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Blockchain pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.