Pour commencer

Cosmos Pay vous permet d'accepter des paiements sur Stellar, Solana et Monad à l'aide des intentions de paiement : vous décrivez un paiement, le payeur le complète depuis son propre portefeuille, et vous le confirmez sur la chaîne. Autour de ce cœur, vous bénéficiez aussi de swaps (sur chaque réseau et entre eux), de webhooks, produits, clients et analyses.

Il existe deux façons d'intégrer, et la plupart des applications utilisent les deux ensemble :

Comment fonctionne un paiement

Chaque paiement passe par les trois mêmes étapes (ici avec le SDK, sur Stellar) :

1. Votre serveur crée une intention avec votre clé API secrète, par ex. client.paymentIntents.createPay({ ... }). Vous récupérez un uri SEP-7 et un qr à présenter au payeur.
2. Le payeur la complète dans son portefeuille Stellar (Freighter, xBull, Rabet, LOBSTR ou Albedo). Dans le navigateur, c'est un seul appel : new WebClient().pay(intent), qui renvoie un txHash sur la chaîne.
3. Votre serveur valide ce hash avec intent.validate(txHash), ce qui met à jour le statut du paiement et déclenche un webhook vers vos points de terminaison.

Sur Solana et Monad, indiquez chain, avec le SDK (createPay({ chain: 'solana', ... }), depuis la version 2.2) ou l'API REST : vous obtenez un lien Solana Pay ou EIP-681 au lieu d'un lien SEP-7, le payeur le règle depuis n'importe quel portefeuille de ce réseau, et l'API Payments détecte le paiement sur la chaîne et déclenche les mêmes webhooks.

Avant de commencer

1. Obtenez une clé API : connectez-vous à la plateforme développeur et générez-en une. Voir Obtenez votre clé API.
2. Installez le SDK : npm install @cosmosapp/pay_sdk (Node.js ≥ 18). Voir Installation.
3. Gardez la clé sur votre serveur. C'est un secret ; le client web du navigateur n'en a jamais besoin.

Votre premier paiement

import { Client, Assets } from '@cosmosapp/pay_sdk';

const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });

const intent = await client.paymentIntents.createPay({
  destination: 'G...YOUR_MERCHANT_ACCOUNT',
  amount: '10',
  asset: Assets.XLM,
  msg: 'Order #1001',
});

console.log(intent.uri); // show as a link / button
console.log(intent.qr);  // render this data: URL as an <img>

Étapes suivantes