Aller au contenu principal

Intégration des smart contracts

Une intégration de paiement non dépositaire type comprend trois composants :

  • Votre application
  • Un fournisseur de connexion de portefeuille
  • Le smart contract de paiement

Le fournisseur de connexion de portefeuille se charge uniquement de connecter le portefeuille du client et de demander la signature de la transaction. Le paiement lui-même est exécuté par le smart contract sur la blockchain.

astuce

Contactez notre équipe avant de commencer l’intégration. Nous vous fournirons les informations du smart contract et l’ABI, et vous aiderons à choisir l’architecture adaptée à votre application.

Parcours de paiement​

  1. Le client arrive sur votre page de paiement.
  2. Le client connecte son portefeuille.
  3. Votre application prépare une transaction de paiement.
  4. La transaction est soumise au portefeuille connecté.
  5. Le client vérifie et signe la transaction.
  6. Le portefeuille diffuse la transaction signée sur la blockchain.
  7. Le smart contract transfère les fonds.
  8. Le portefeuille reçoit un hash de transaction (txid) et le renvoie à votre application.
  9. Votre application suit la transaction jusqu’à ce qu’elle atteigne le niveau de confirmation requis.
  10. Votre système marque la commande comme payée.

Prérequis​

Avant l’intégration, vous avez besoin :

  • D’une application frontend capable de connecter des portefeuilles crypto.
  • D’un backend (recommandé) pour créer les demandes de paiement et suivre les transactions blockchain.
  • Des informations du smart contract fournies par Volet.com.
  • D’un fournisseur de connexion de portefeuille adapté aux réseaux blockchain que vous prévoyez de prendre en charge.

Configuration initiale​

Étape 1. Configurez la connexion des portefeuilles​

Intégrez un fournisseur de connexion de portefeuille adapté aux réseaux blockchain que vous prévoyez de prendre en charge.

Options courantes :

  • WalletConnect : Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche et autres réseaux compatibles EVM.
  • TronLink : Tron.
  • TON Connect : TON.
  • Solana Wallet Adapter : Solana.

Certains fournisseurs, comme WalletConnect, nécessitent un Project ID ou des identifiants d’API avant utilisation.

Étape 2. Obtenez les informations du smart contract​

Contactez Volet.com pour obtenir l’adresse du smart contract, l’ABI et les éventuels paramètres propres à l’intégration.

Mise en œuvre du parcours de paiement​

Étape 1. Connectez le portefeuille du client​

Invitez le client à connecter un portefeuille compatible.

Par exemple :

  • MetaMask ou Trust Wallet via WalletConnect.
  • TronLink pour Tron.
  • Tonkeeper via TON Connect.
  • Phantom ou Solflare via Solana Wallet Adapter.

Étape 2. Préparez la transaction​

Préparez une demande de transaction dans votre application.

Elle comprend généralement :

  • L’adresse du portefeuille destinataire
  • Le montant du paiement
  • Le token
  • Le réseau blockchain (chainId)
  • L’identifiant de commande
  • Des métadonnées facultatives

La transaction peut être préparée côté frontend ou côté backend.

Étape 3. Demandez la signature de la transaction​

Soumettez la transaction préparée au portefeuille connecté.

À partir du chainId indiqué, le portefeuille sélectionne automatiquement le réseau blockchain et le point de terminaison RPC appropriés.

Le client vérifie le détail de la transaction.

Si tout est correct, il signe la transaction dans son portefeuille.

Étape 4. Diffusez la transaction​

Une fois la transaction signée, le portefeuille la diffuse sur la blockchain via le point de terminaison RPC approprié.

Si le réseau accepte la transaction, le portefeuille reçoit un hash de transaction (txid) et le renvoie à votre application.

Enregistrez le hash de la transaction avec votre commande.

Étape 5. Vérifiez les confirmations de la transaction​

Surveillez la blockchain à l’aide du hash de transaction jusqu’à ce que le paiement atteigne le niveau de confirmation requis.

Une fois la transaction suffisamment confirmée, marquez la commande comme payée dans votre système.

Fournisseurs RPC​

Les portefeuilles des clients choisissent automatiquement un point de terminaison RPC selon le chainId de la transaction : aucune configuration supplémentaire n’est nécessaire pour une intégration de base.

Si votre application effectue un grand nombre de requêtes blockchain (par exemple pour surveiller les transactions de paiement ou interroger des données blockchain à grande échelle), envisagez d’utiliser :

  • Un fournisseur RPC dédié.
  • Votre propre nœud RPC.

Une infrastructure dédiée permet d’éviter les limites de requêtes des RPC publics et améliore la fiabilité en cas de forte charge.

Et ensuite​

  • Consultez la référence du smart contract.
  • Testez les scénarios de paiement réussi et échoué.
  • Vérifiez le traitement des confirmations de transaction.
  • Déployez en production.