Comment accepter des paiements en USDC en ligne
Pour accepter l’USDC en ligne avec Cosmos Pay, ajoutez le wallet qui recevra l’argent, puis encaissez avec un lien de paiement, le checkout hébergé ou l’API de paiement. Votre client paie depuis son propre wallet sur Stellar, Solana ou Monad, et l’USDC arrive à votre adresse. Faites un essai sur un réseau de test avant d’encaisser de l’argent réel.
Ce qu’il vous faut
Un compte Cosmos Pay. Sa création est gratuite, et l’offre Starter n’a pas d’abonnement mensuel : chaque paiement coûte 1.5% + 18¢.
Une adresse de wallet qui recevra l’USDC, sur le réseau où vous encaissez : Stellar, Solana ou Monad. Vous l’ajoutez à votre organisation dans le tableau de bord et prouvez qu’elle est à vous par une signature. Les liens de paiement créés dans le tableau de bord ne versent l’argent qu’aux wallets qui y sont ajoutés.
Ce qu’il faut à votre client
Un wallet sur le même réseau, qui détient l’USDC et peut ouvrir le paiement : sur Stellar, tout wallet qui ouvre les liens SEP-7 ; sur Solana, tout wallet qui lit les liens Solana Pay ; sur Monad, tout wallet EVM qui lit les liens EIP-681. Son wallet règle aussi les frais de réseau.
Aucun compte. Votre client ouvre le checkout, scanne le QR code ou touche le bouton de son wallet, puis approuve le paiement dans son wallet.
Trois façons d’encaisser
Toutes les trois utilisent le même checkout, le même tableau de bord et les mêmes webhooks : vous pouvez commencer avec un lien et passer à l’API quand vous en avez besoin.
- Lien de paiement : créez-le dans le tableau de bord et envoyez-le par chat ou par e-mail, ou montrez son QR code. Sans code.
- Checkout hébergé : envoyez votre client vers la page de paiement du lien, ouvrez-la depuis un bouton de paiement ou affichez-la dans votre page avec une seule balise script.
- API de paiement : créez chaque paiement depuis votre serveur avec une requête, ou avec le SDK TypeScript, et dessinez votre propre écran de paiement.
Envoyer un lien de paiement sur WhatsAppEssayer chaque option d’intégrationIntégrer un paiement
Acceptez votre premier paiement en USDC, étape par étape
Créez votre compte et passez en Sandbox
Connectez-vous au tableau de bord et choisissez Sandbox en haut. Ce que vous y créez fonctionne sur les réseaux de test (Stellar Testnet, Solana Devnet et Monad Testnet) et ne déplace aucun argent réel.
Ajoutez le wallet qui reçoit l’argent
Dans les paramètres de votre organisation, ajoutez un wallet sur le réseau où vous encaisserez, puis signez ce que le tableau de bord demande pour prouver que ce wallet est à vous.
Créez un paiement de test
Dans Paiements, créez un lien de paiement avec le réseau, le montant, l’actif et le wallet qui le reçoit. Ou créez une clé d’API de test (elle commence par dv_) et appelez POST /v1/payment-intents/pay depuis votre serveur. Sur Stellar Testnet, vous pouvez encaisser en XLM, que Friendbot, le faucet de Testnet, envoie à un compte de test.
Payez-le depuis un wallet de test
Ouvrez la page de paiement : elle indique qu’elle fonctionne sur un réseau de test. Payez depuis un wallet sur ce réseau, puis regardez le checkout passer à Payé et le lien à Réussi dans le tableau de bord.
Confirmez les paiements sur votre serveur
Ajoutez un endpoint webhook dans le tableau de bord. Quand le réseau confirme un paiement, Cosmos Pay envoie PAYMENT_INTENT_SUCCEEDED, signé en HMAC-SHA256. Livrez la commande quand cet événement arrive, pas quand la page du client affiche qu’elle est payée.
Passez en Production
Choisissez Production dans le tableau de bord et créez une clé d’API de production (elle commence par prod_). Les mêmes requêtes encaissent alors sur les réseaux principaux : la clé choisit le réseau, pas le code.
Premiers pasClés d’APIWebhooksAPI des intentions de paiement
Sur quel réseau encaisser
Encaissez sur le réseau où vos clients détiennent déjà de l’USDC. L’USDC est préconfiguré sur Stellar et Solana, sur leurs réseaux principaux et de test, ainsi que sur le réseau principal de Monad. Sur les trois, tout autre jeton peut être encaissé en l’indiquant par son émetteur, son mint ou son contrat.
Stellar vs Solana vs MonadPaiements sur StellarPaiements sur SolanaPaiements sur Monad
Ce que ça coûte
Chaque paiement paie le tarif de votre offre, le même sur chaque réseau : 1.5% + 18¢ avec Starter, sans abonnement mensuel. Le wallet du payeur règle les frais de réseau ; sur Monad, le relais qui vous transfère le paiement en déduit ses frais.
Questions et réponses.
Paiements par réseau :Paiements sur StellarPaiements sur SolanaPaiements sur Monad
Puis-je accepter l’USDC sans écrire de code ?
Oui. Créez un lien de paiement dans le tableau de bord et partagez-le par chat ou par e-mail, ou montrez son QR code. Le statut de chaque paiement s’affiche dans le tableau de bord.
Mon client paie-t-il en USDC, et est-ce que je reçois de l’USDC ?
Oui. Votre client paie dans l’actif défini sur le lien, et ce même actif arrive à votre adresse.
Puis-je essayer sans argent réel ?
Oui. En Sandbox et avec des clés de test (dv_), les liens fonctionnent sur des réseaux de test, et leur checkout indique qu’aucun fonds réel ne circule.
Un client peut-il annuler un paiement en USDC ?
Non. Une fois le paiement confirmé par le réseau, il est définitif. Un remboursement est un nouveau paiement que vous envoyez depuis votre wallet.
