Introduction
Intégrez des paiements multichaînes sur Stellar, Solana et Monad avec Cosmos Pay, grâce au SDK JavaScript/TypeScript et à l'API REST Payments.
Cosmos Pay vous permet d'accepter des paiements sur Stellar, Solana et Monad (intentions de paiement avec des liens SEP-7, Solana Pay et EIP-681), de faire des swaps sur ces réseaux et entre eux, et de gérer les webhooks, les produits, les clients et les analyses. Cette documentation couvre les deux façons d'intégrer :
SDK · Aperçu
Ce qu'est @cosmosapp/pay_sdk, les points d'entrée serveur + navigateur, et le modèle mental.
SDK · Démarrage rapide
Le flux de bout en bout le plus simple : créer une intention, la compléter dans le portefeuille, la valider.
Référence de l'API
L'API REST Payments (OpenAPI) : intentions de paiement, webhooks, produits, clients, analyses.
Webhooks
Enregistrez des points de terminaison, recevez des événements et vérifiez les signatures.
Le flux de paiement
Un paiement comporte trois étapes (ici avec le SDK, sur Stellar) :
- Le serveur crée une intention avec votre clé API secrète (
client.paymentIntents.createPay/createTx). - Le navigateur la complète avec le portefeuille Stellar de l'utilisateur (
new WebClient().pay(intent)), produisant untxHashsur la chaîne. - Le serveur valide ce hash (
intent.validate(txHash)), ce qui met à jour le statut et déclenche un webhook.
Le réseau est choisi par le type de clé API : les clés dv_ ciblent le testnet, les clés prod_ ciblent le mainnet.
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, 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.