Erste Schritte

Mit Cosmos Pay akzeptieren Sie Zahlungen auf Stellar, Solana und Monad über Zahlungsabsichten: Sie beschreiben eine Zahlung, der Zahler schließt sie aus seinem eigenen Wallet ab, und Sie bestätigen sie On-Chain. Rund um diesen Kern erhalten Sie außerdem Swaps (auf jeder Chain und zwischen ihnen), Webhooks, Produkte, Kunden und Analysen.

Es gibt zwei Integrationswege, und die meisten Anwendungen nutzen beide gemeinsam:

So funktioniert eine Zahlung

Jede Zahlung durchläuft dieselben drei Schritte (hier mit dem SDK, auf Stellar):

1. Ihr Server erstellt eine Absicht mit Ihrem geheimen API-Schlüssel, z. B. client.paymentIntents.createPay({ ... }). Sie erhalten eine SEP-7-uri und einen qr, die Sie dem Zahler anzeigen.
2. Der Zahler schließt sie ab in seinem Stellar-Wallet (Freighter, xBull, Rabet, LOBSTR oder Albedo). Im Browser ist das ein einziger Aufruf: new WebClient().pay(intent), der einen On-Chain-txHash zurückgibt.
3. Ihr Server validiert diesen Hash mit intent.validate(txHash), wodurch der Status der Zahlung aktualisiert und ein Webhook an Ihre Endpunkte ausgelöst wird.

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 statt eines SEP-7-Links, 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.

Bevor Sie beginnen

1. Holen Sie sich einen API-Schlüssel: Melden Sie sich an der Entwicklerplattform an und erzeugen Sie einen. Siehe API-Schlüssel holen.
2. Installieren Sie das SDK: npm install @cosmosapp/pay_sdk (Node.js ≥ 18). Siehe Installation.
3. Bewahren Sie den Schlüssel auf Ihrem Server auf. Er ist geheim; der Browser-Web-Client benötigt ihn nie.

Ihre erste Zahlung

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>

Nächste Schritte