Einführung
Integrieren Sie Multi-Chain-Zahlungen auf Stellar, Solana und Monad mit Cosmos Pay, über das JavaScript/TypeScript-SDK und die Payments-REST-API.
Mit Cosmos Pay akzeptieren Sie Zahlungen auf Stellar, Solana und Monad (Zahlungsabsichten mit SEP-7-, Solana-Pay- und EIP-681-Links), tauschen auf und zwischen diesen Chains und verwalten Webhooks, Produkte, Kunden und Analysen. Diese Dokumentation behandelt beide Integrationswege:
SDK · Überblick
Was @cosmosapp/pay_sdk ist, die Server- und Browser-Einstiegspunkte und das mentale Modell.
SDK · Schnellstart
Der kleinste End-to-End-Ablauf: eine Absicht erstellen, sie im Wallet abschließen, sie validieren.
API-Referenz
Die Payments-REST-API (OpenAPI): Zahlungsabsichten, Webhooks, Produkte, Kunden, Analysen.
Webhooks
Endpunkte registrieren, Ereignisse empfangen und Signaturen verifizieren.
Der Zahlungsablauf
Eine Zahlung besteht aus drei Schritten (hier mit dem SDK, auf Stellar):
- Der Server erstellt eine Absicht mit Ihrem geheimen API-Schlüssel (
client.paymentIntents.createPay/createTx). - Der Browser schließt sie mit dem Stellar-Wallet des Nutzers ab (
new WebClient().pay(intent)) und erzeugt einen On-Chain-txHash. - Der Server validiert diesen Hash (
intent.validate(txHash)), wodurch der Status aktualisiert und ein Webhook ausgelöst wird.
Das Netzwerk wird durch den Typ des API-Schlüssels bestimmt: dv_-Schlüssel verwenden das Testnet, prod_-Schlüssel das Mainnet.
Auf Solana und Monad geben Sie chain an, mit dem SDK (createPay({ chain: 'solana', ... }), ab Version 2.2) oder über die REST-API:
Sie erhalten einen Solana-Pay- oder EIP-681-Link, der Zahler bezahlt ihn aus einem beliebigen Wallet dieser Chain,
und die Payments-API erkennt die Zahlung on-chain und löst dieselben Webhooks aus.