# Liens de paiement Solana Pay, étape par étape | Cosmos Pay

URL: https://payments.cosmospay.lat/learn/accept-usdc-with-solana-pay?lang=fr

> Encaissez en USDC sur Solana avec un lien et un QR code Solana Pay : contenu du lien, tests sur Devnet et confirmation de chaque paiement.

## 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.

Mis à jour le 2 novembre 2026 · Par Cosmos Pay

### 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.

- [La spécification Solana Pay](https://solana.com/docs/tools/solana-pay/specification/version1-1)
- [Paiements sur Solana](https://payments.cosmospay.lat/solana?lang=fr)

### 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

1. **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.
2. **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.
3. **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.
4. **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.
5. **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.
6. **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.

- [Comment confirmer un paiement sur votre serveur](https://payments.cosmospay.lat/learn/confirm-stablecoin-payments?lang=fr)
- [Clés d’API](https://dev.cosmospay.lat/docs/api-keys/)

### 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 paiement](https://dev.cosmospay.lat/docs/api/payment-intents/)
- [Les intentions de paiement dans le SDK](https://dev.cosmospay.lat/docs/sdk/server/payment-intents/)

### 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.

- [Tarifs et calculateur de frais](https://payments.cosmospay.lat/fees?lang=fr)
- [Stellar vs Solana vs Monad](https://payments.cosmospay.lat/learn/stellar-vs-solana-vs-monad?lang=fr)

### Questions et réponses.

Paiements par réseau : [Paiements sur Stellar](https://payments.cosmospay.lat/stellar?lang=fr), [Paiements sur Solana](https://payments.cosmospay.lat/solana?lang=fr), [Paiements sur Monad](https://payments.cosmospay.lat/monad?lang=fr)

#### 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.

### Plus de guides

[Voir tous les guides](https://payments.cosmospay.lat/learn?lang=fr)

#### [Comment accepter des paiements en USDC en ligne](https://payments.cosmospay.lat/learn/accept-usdc-payments?lang=fr)

Encaissez en USDC avec un lien de paiement, le checkout hébergé ou l’API, et faites d’abord un essai sur un réseau de test.

#### [Comment confirmer un paiement en stablecoins sur votre serveur](https://payments.cosmospay.lat/learn/confirm-stablecoin-payments?lang=fr)

Livrez les commandes à partir d’un webhook signé, pas de la page de votre client : vérifiez-le, répondez vite et ignorez les doublons.

#### [Stellar vs Solana vs Monad pour accepter des paiements](https://payments.cosmospay.lat/learn/stellar-vs-solana-vs-monad?lang=fr)

Les trois réseaux côte à côte, tels que Cosmos Pay les prend en charge : format de lien, actifs, réseaux de test et frais.

### Commencez à accepter les stablecoins.

Créez un compte gratuit, générez une clé de test et envoyez votre premier lien de paiement dès aujourd’hui.

[Créer un lien de paiement](https://dev.cosmospay.lat/login?next=%2Fdashboard%3Fview%3Dpayments)

#### Écrivez-nous

Une question sur les offres, l’intégration ou les paiements protégés : dites-le-nous, nous répondons par e-mail.

[organization@cosmospay.lat](mailto:organization@cosmospay.lat)
