Comment accepter l’USDC avec des liens Solana Pay
Avec Cosmos Pay, un lien de paiement sur Solana est une demande de transfert Solana Pay : votre client scanne son QR code ou l’ouvre dans un wallet comme Phantom ou Solflare, puis y approuve le paiement en USDC. L’USDC va directement sur votre wallet, et Cosmos Pay marque le lien comme payé dès que Solana confirme la transaction. Faites un essai sur Devnet avant d’encaisser de l’argent réel.
Ce que contient un lien Solana Pay
Solana Pay est une norme de demandes de paiement que lisent les wallets Solana : un lien solana:, ou son QR code, avec l’adresse à payer, le montant, le jeton et un message.
Cosmos Pay ajoute une clé de référence créée pour chaque lien. Le wallet l’inclut dans la transaction, et Cosmos Pay recherche cette clé sur Solana pour rattacher le paiement à son lien. Cosmos Pay n’accepte le paiement que si la transaction a réussi et que le montant exact est arrivé à votre adresse.
Ce qu’il vous faut, à vous et à votre client
- Vous : une adresse Solana qui reçoit l’argent, ajoutée à votre organisation dans le tableau de bord, où vous prouvez par une signature qu’elle est à vous.
- Votre client : un wallet Solana qui lit les liens Solana Pay, comme Phantom ou Solflare, avec l’USDC et un peu de SOL pour les frais de réseau. Aucun compte chez Cosmos Pay.
- Pour les tests : Sandbox, où les liens fonctionnent sur Solana Devnet. L’USDC y est aussi préconfiguré : vous pouvez donc tester avec de l’USDC Devnet.
Acceptez votre premier paiement Solana Pay
Passez en Sandbox
Connectez-vous au tableau de bord et choisissez Sandbox en haut. Les liens que vous y créez fonctionnent sur Solana Devnet et ne déplacent aucun argent réel.
Ajoutez votre wallet Solana
Dans les paramètres de votre organisation, ajoutez l’adresse Solana qui recevra l’argent, puis signez ce que le tableau de bord demande pour prouver que ce wallet est à vous.
Créez le lien
Dans Paiements, cliquez sur Créer un lien de paiement, choisissez Solana et remplacez l’actif par l’USDC (le sélecteur démarre sur SOL). Saisissez le montant, ou laissez-le vide pour que votre client le choisisse, puis choisissez votre wallet et, si vous le souhaitez, un message.
Payez-le depuis un wallet
Ouvrez la page de paiement et scannez son QR code avec un wallet Solana, ou ouvrez le lien sur le même appareil. Approuvez le paiement dans le wallet : le checkout passe à Payé dès que Solana le confirme.
Confirmez-le sur votre serveur
Ajoutez un endpoint webhook dans le tableau de bord. Quand le paiement est confirmé, Cosmos Pay envoie PAYMENT_INTENT_SUCCEEDED, signé en HMAC-SHA256. Livrez la commande quand cet événement arrive.
Passez en Production
Choisissez Production et créez une clé d’API de production (elle commence par prod_). Les liens fonctionnent alors sur le réseau principal de Solana, où l’USDC a sa propre préconfiguration.
Créer le lien depuis votre serveur
Avec l’API de paiement, appelez POST /v1/payment-intents/pay avec chain défini sur solana, votre adresse comme destination et, pour l’USDC, le code d’actif USDC avec son mint comme émetteur. Avec le SDK TypeScript (version 2.2 ou ultérieure), passez chain: 'solana' à client.paymentIntents.createPay.
La réponse contient le lien (son uri commence par solana:) et son QR code. Affichez le QR code, ouvrez le lien dans le wallet de votre client ou envoyez votre client vers le checkout hébergé : payments.cosmospay.lat suivi de l’id du lien.
API des intentions de paiementLes intentions de paiement dans le SDK
Bon à savoir
- Vous pouvez laisser le montant vide pour que votre client le choisisse, comme pour des dons. Un lien qui ajoute vos propres frais exige un montant.
- Un message de 300 caractères maximum, comme un numéro de commande, s’affiche dans le wallet de votre client.
- Avec vos propres frais sur le paiement, le lien devient une demande de transaction Solana Pay qui paie votre wallet et votre wallet de frais en une seule transaction.
- Un lien reste ouvert pendant une durée limitée, que le checkout affiche en compte à rebours. Un paiement qui arrive quand même et que le réseau confirme le marque comme payé.
- Le wallet de votre client règle les frais de réseau Solana, en SOL. Chaque paiement paie le tarif de votre offre, le même que sur chaque réseau.
Questions et réponses.
Paiements par réseau :Paiements sur StellarPaiements sur SolanaPaiements sur Monad
Quels wallets peuvent payer un lien Solana Pay ?
Tout wallet Solana qui lit les liens Solana Pay, comme Phantom ou Solflare. Votre client scanne le QR code ou ouvre le lien, puis approuve le paiement dans le wallet.
Mon client a-t-il besoin de SOL ?
Oui, un peu. Son wallet règle les frais de réseau Solana en SOL, en plus de l’USDC qu’il envoie.
L’USDC passe-t-il par Cosmos Pay ?
Non. Sur Solana, le wallet de votre client envoie l’USDC directement à votre adresse. Cosmos Pay retrouve le paiement sur le réseau grâce à la clé de référence du lien.
Puis-je tester sans argent réel ?
Oui. En Sandbox et avec des clés de test (dv_), les liens fonctionnent sur Solana Devnet, où l’USDC est préconfiguré, et le checkout indique qu’aucun fonds réel ne circule.
