Intégration des smart contracts

Acceptez des paiements en cryptomonnaies directement sur votre propre portefeuille grâce aux smart contracts de Volet.com. Vos clients connectent leur portefeuille crypto et approuvent les transactions ; le smart contract traite le paiement et répartit les fonds et les frais de traitement on-chain.

Ni vous ni vos clients n’avez besoin d’un compte Volet.com. Vous contrôlez votre portefeuille de réception et gérez la confirmation des paiements dans votre propre application.

Important : cette intégration n’utilise ni Hosted Checkout ni les factures de la Merchant API. Votre application fournit l’interface de paiement et vérifie les paiements directement sur la blockchain. Volet.com n’envoie pas de notifications de statut de paiement pour ce parcours.

Fonctionnement

Une intégration de paiement non dépositaire fait intervenir trois composants :

• Votre application : crée les commandes, initie les paiements et vérifie les transactions.
• Le portefeuille du client : se connecte à votre application et signe les transactions de paiement.
• Le smart contract de Volet.com : traite les paiements, transfère les fonds vers votre portefeuille et prélève les frais de traitement.

Parcours de paiement

1. Créez une commande. Votre backend enregistre le montant du paiement, l’actif, le réseau blockchain et le portefeuille de réception du marchand.
2. Connectez le portefeuille du client. Votre application demande la connexion d’un portefeuille crypto compatible.
3. Calculez le paiement. La fonction previewPayment() du smart contract renvoie les frais de traitement et le montant que le client doit payer.
4. Demandez le paiement. Le client vérifie et signe la transaction. Les paiements en jetons comme l’USDT peuvent d’abord nécessiter une approbation distincte.
5. La transaction est traitée. Le smart contract transfère les fonds vers votre portefeuille et prélève les frais de traitement.
6. Enregistrez la transaction. Votre application enregistre le hash de transaction (txid) et l’associe à la commande.
7. Vérifiez le paiement. Votre backend vérifie la transaction de manière indépendante : statut, réseau, contrat, actif, destinataire, montant et finalité sur la blockchain.
8. Finalisez la commande. Une fois la vérification réussie, votre application marque la commande comme payée et l’exécute une seule fois.

Important : un hash de transaction, une approbation dans le portefeuille ou un statut de transaction réussi ne suffisent pas à confirmer qu’une commande est payée. Vérifiez toujours les détails du paiement sur votre backend avant d’exécuter une commande.

Choisissez votre réseau

Choisissez le guide d’intégration selon les réseaux et les actifs que vous souhaitez accepter.

Réseau	Actifs couverts par ces guides	Portefeuilles des clients	Guide d’intégration
Ethereum et BNB Smart Chain	ETH, BNB, USDT (ERC-20 et BEP-20)	MetaMask et portefeuilles compatibles WalletConnect	Intégration EVM
TRON	TRX, USDT (TRC-20)	TronLink ; WalletConnect via une intégration distincte	Intégration TRON

D’autres réseaux et actifs peuvent nécessiter des implémentations distinctes. Consultez Accepter les paiements crypto non dépositaires pour une présentation du produit et des options disponibles.

Avant de commencer

Vous aurez besoin :

• D’un portefeuille marchand : un portefeuille crypto que vous contrôlez pour recevoir les paiements.
• D’une application : un site web ou une application dotée d’une interface de paiement.
• D’un backend et d’une base de données : pour créer les commandes, stocker les détails des transactions et vérifier les paiements.
• D’une intégration de portefeuilles : une bibliothèque de connexion de portefeuilles compatible avec le réseau choisi.
• Des informations du smart contract : les adresses des contrats processeurs, l’ABI et les paramètres fournis par Volet.com.
• D’un accès à la blockchain : un fournisseur RPC ou un service blockchain hébergé pour vérifier les transactions.

Selon votre intégration, vous aurez peut-être aussi besoin d’un Project ID WalletConnect ou d’une clé d’API TronGrid.

Contactez notre équipe pour obtenir les informations du smart contract et discuter de votre intégration.

Frais de traitement

Le smart contract calcule les frais de traitement avec previewPayment(). Votre application choisit qui les paie :

• Le client paie : les frais s’ajoutent au montant du paiement. Le marchand reçoit le montant demandé.
• Le marchand paie : les frais sont déduits du montant demandé. Le marchand reçoit le reste.

Les frais de réseau de la blockchain, comme le gas sur Ethereum ou les coûts d’Energy et de Bandwidth sur TRON, s’ajoutent séparément aux frais de traitement de Volet.com.

Utilisez toujours les montants renvoyés par previewPayment() au lieu de calculer les frais manuellement.

Les paramètres du contrat et le calcul des frais sont décrits dans la Référence des smart contracts.

Guides d’intégration

Suivez ces étapes pour finaliser votre intégration :

1. Mettez en œuvre le parcours de paiement. Suivez le guide Ethereum et BNB Smart Chain ou le guide TRON pour connecter les portefeuilles des clients, configurer les smart contracts et envoyer les paiements.
2. Mettez en œuvre la vérification des paiements. Suivez Vérification des paiements et suivi des commandes pour rapprocher les transactions blockchain des commandes et éviter les exécutions en double.
3. Testez votre intégration. Avant la mise en production, testez les paiements réussis et échoués, les approbations de jetons, les transactions refusées et la vérification des paiements.

Ressources complémentaires :

• Référence des smart contracts — adresses des processeurs, décimales des jetons, fonctions et paramètres des contrats.
• Dépannage — erreurs courantes liées aux portefeuilles, aux transactions et aux contrats.

Exemples d’intégration

Les guides de chaque réseau incluent des exemples HTML que vous pouvez ouvrir dans votre navigateur ou télécharger :

• Exemple EVM (example-evm.html) : connexion de portefeuilles, calcul des frais, paiements en ETH, BNB et USDT, et suivi des transactions.
• Exemple TRON (example-tron.html) : connexion de TronLink, calcul des frais, paiements en TRX et USDT, et suivi des transactions.

Chaque guide explique comment utiliser son exemple.

Important : les deux exemples utilisent des contrats sur le mainnet. Tout paiement confirmé dans votre portefeuille engage des fonds réels. Pour tester des paiements, il vous faut deux portefeuilles : l’un pour envoyer les fonds, l’autre pour les recevoir.

Limites de la démo : les exemples stockent l’historique des transactions dans le localStorage du navigateur. Ils n’incluent ni backend de production ni vérification complète des paiements. Adaptez-les et testez-les avant d’accepter de vrais paiements de clients.

Intégrer avec un assistant de programmation IA

Un assistant de programmation IA peut vous aider à intégrer les paiements par smart contracts de Volet.com dans votre application existante.

Utilisez notre prompt d’intégration prêt à l’emploi, qui couvre la connexion des portefeuilles, le traitement des paiements, la vérification côté backend, le suivi des commandes et les tests.

Fournissez à votre assistant IA le prompt, le code source de votre application et les guides d’intégration correspondants.

Important : relisez et testez tout le code généré par l’IA avant de traiter de vrais paiements. Vérifiez les adresses des contrats, la logique de validation des paiements et le traitement des transactions.

Voir aussi

• Accepter les paiements crypto non dépositaires — découvrez l’acceptation des paiements non dépositaires et ses fonctionnalités.