So nimmst du USDC auf Stellar mit SEP-7-Links an

Was ein SEP-7-Link enthält

SEP-7 ist der Standard von Stellar für Zahlungsanforderungen: ein web+stellar:pay-Link oder sein QR-Code mit deiner Adresse, dem Betrag, dem Asset und seinem Herausgeber sowie einem numerischen Memo.

Cosmos Pay erstellt für jeden Link ein Memo und sucht in den Zahlungen an dein Konto danach. Es akzeptiert eine Zahlung, die nach dem Erstellen des Links mit diesem Memo an deine Adresse geht, im Asset des Links und, wenn der Link einen Betrag festlegt, über genau diesen Betrag.

Der Standard SEP-7 (Stellar)Zahlungen auf Stellar

Bereite dein Konto vor

• Dein Stellar-Konto muss im Netzwerk existieren und eine Trustline für USDC haben, bevor es USDC empfangen kann. Cosmos Pay prüft das nicht, wenn du das Konto hinzufügst, und eine Zahlung an ein Konto ohne die Trustline schlägt fehl, nachdem dein Kunde signiert hat.
• Füge das Konto im Dashboard deiner Organisation hinzu und signiere, was es anfordert. Damit beweist du, dass das Konto dir gehört.
• Für Tests machst du dasselbe im Testnet. Friendbot, der Faucet des Testnets, sendet Test-XLM an ein Konto, und Links können dort in XLM kassieren.

Was dein Kunde braucht

• Eine Stellar-Wallet, die SEP-7-Links öffnet, etwa Cosmos Pay Wallet, Freighter, LOBSTR, xBull, Albedo oder Rabet, mit den USDC und etwas XLM für die Netzwerkgebühr. Kein Konto bei Cosmos Pay.
• Eine direkte USDC-Zahlung. Eine Wallet, die unterwegs ein anderes Asset in USDC umtauscht (ein Path Payment), begleicht den Link nicht.
• Im Testnet eine Wallet, die vor dem Bezahlen auf Testnet gestellt ist: Der Link nennt das Netzwerk nicht, und eine Wallet, die SEP-7 folgt, geht dann vom Mainnet aus.

Deine erste USDC-Zahlung auf Stellar annehmen

1. Wechsle in die Sandbox

   Melde dich im Dashboard an und wähle oben „Sandbox“. Links, die du dort erstellst, laufen im Stellar Testnet und bewegen kein echtes Geld.

2. Füge dein Stellar-Konto hinzu

   Stelle sicher, dass das Konto existiert und eine Trustline für USDC hat, füge es dann in den Einstellungen deiner Organisation hinzu und signiere, was das Dashboard anfordert.

3. Erstelle den Link

   Wähle unter „Zahlungen“ „Zahlungslink erstellen“, dann Stellar, den Betrag (oder keinen) und USDC, danach dein Konto und, wenn du möchtest, eine Nachricht.

4. Bezahle ihn aus einer Wallet

   Öffne die Bezahlseite und scanne ihren QR-Code mit einer Stellar-Wallet, die auf dasselbe Netzwerk gestellt ist, oder öffne den Link auf demselben Gerät. Bestätige die Zahlung, und der Checkout springt auf „Bezahlt“, sobald Cosmos Pay sie findet.

5. Bestätige sie auf deinem Server

   Füge im Dashboard einen Webhook-Endpunkt hinzu. Wenn die Zahlung bestätigt ist, sendet Cosmos Pay PAYMENT_INTENT_SUCCEEDED, signiert mit HMAC-SHA256. Liefere die Bestellung aus, wenn dieses Ereignis ankommt.

6. Wechsle in die Produktion

   Wähle „Produktion“ und erstelle einen Produktions-API-Schlüssel (er beginnt mit prod_). Links laufen jetzt im Mainnet von Stellar, wo USDC von Circle voreingestellt ist.

So bestätigst du eine Zahlung auf deinem ServerAPI-Schlüssel

Den Link von deinem Server aus erstellen

Rufe POST /v1/payment-intents/pay mit deinem Konto als Ziel, dem Betrag und, für USDC, dem Asset-Code mit seinem Herausgeber auf, oder nutze client.paymentIntents.createPay im TypeScript-SDK: Stellar ist der Standardwert für chain. Die Antwort enthält den Link (seine uri beginnt mit web+stellar:pay) und seinen QR-Code.

Wenn du das Konto deines Kunden kennst, gibt eine Transaktionsabsicht (POST /v1/payment-intents/tx oder createTx im SDK) stattdessen eine unsignierte Transaktion zurück, die er signiert. Sie muss innerhalb von fünf Minuten signiert werden.

Wenn du ein eigenes Memo setzt, verwende es nur für eine Zahlung: Dasselbe Memo mit anderen Bedingungen wird abgelehnt.

API für ZahlungsabsichtenZahlungsabsichten im SDK

Gut zu wissen

• Du kannst den Betrag leer lassen und ihn deinen Kunden wählen lassen. Eine Nachricht mit bis zu 300 Zeichen erscheint in der Wallet deines Kunden.
• Mit deiner eigenen Gebühr auf der Zahlung fragt der Checkout nach dem Konto deines Kunden und baut eine Transaktion, die dich und deine Gebühren-Wallet bezahlt.
• Im Dashboard hat ein ausstehender Stellar-Link eine Prüfung, die ihn anhand eines Transaktions-Hashs begleicht.
• Eine Zahlung, die nach Ablauf des Links ankommt, begleicht ihn, wenn du ihren Transaktions-Hash an POST /v1/payment-intents/:id/validate sendest.
• Die Wallet deines Kunden zahlt die Netzwerkgebühr von Stellar in XLM. Private Zahlungen, die den Betrag on-chain verbergen, laufen auf Stellar in XLM, vorerst im Testnet.

Preise und GebührenrechnerStellar vs. Solana vs. Monad