So nimmst du USDC mit Solana-Pay-Links an

Was ein Solana-Pay-Link enthält

Solana Pay ist ein Standard für Zahlungsanforderungen, die Solana-Wallets lesen: ein solana:-Link oder sein QR-Code mit der zu zahlenden Adresse, dem Betrag, dem Token und einer Nachricht.

Cosmos Pay fügt einen Referenzschlüssel hinzu, der für jeden Link angelegt wird. Die Wallet nimmt ihn in die Transaktion auf, und Cosmos Pay sucht auf Solana nach diesem Schlüssel, um die Zahlung ihrem Link zuzuordnen. Cosmos Pay akzeptiert die Zahlung nur, wenn die Transaktion erfolgreich war und genau der Betrag an deiner Adresse angekommen ist.

Die Solana-Pay-SpezifikationZahlungen auf Solana

Was du und dein Kunde braucht

• Du: eine Solana-Adresse, die das Geld empfängt, im Dashboard deiner Organisation hinzugefügt und mit einer Signatur als deine nachgewiesen.
• Dein Kunde: eine Solana-Wallet, die Solana-Pay-Links liest, etwa Phantom oder Solflare, mit den USDC und etwas SOL für die Netzwerkgebühr. Kein Konto bei Cosmos Pay.
• Für Tests: die Sandbox, in der Links im Solana Devnet laufen. Auch dort ist USDC voreingestellt, du kannst also mit Devnet-USDC testen.

Deine erste Solana-Pay-Zahlung annehmen

1. Wechsle in die Sandbox

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

2. Füge deine Solana-Wallet hinzu

   Füge in den Einstellungen deiner Organisation die Solana-Adresse hinzu, die das Geld empfängt, und signiere, was das Dashboard anfordert. Damit beweist du, dass die Wallet dir gehört.

3. Erstelle den Link

   Wähle unter „Zahlungen“ „Zahlungslink erstellen“, dann Solana, und stelle das Asset auf USDC um (die Auswahl beginnt bei SOL). Gib den Betrag ein oder lass ihn leer, damit dein Kunde ihn bestimmt, und wähle dann deine Wallet und, wenn du möchtest, eine Nachricht.

4. Bezahle ihn aus einer Wallet

   Öffne die Bezahlseite und scanne ihren QR-Code mit einer Solana-Wallet oder öffne den Link auf demselben Gerät. Bestätige die Zahlung in der Wallet, und der Checkout springt auf „Bezahlt“, sobald Solana sie bestätigt.

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 Solana, wo USDC eine eigene Voreinstellung hat.

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

Den Link von deinem Server aus erstellen

Rufe mit der Zahlungs-API POST /v1/payment-intents/pay auf, mit chain auf solana, deiner Adresse als Ziel und, für USDC, dem Asset-Code USDC mit seinem Mint als Herausgeber. Mit dem TypeScript-SDK (Version 2.2 oder neuer) übergibst du chain: 'solana' an client.paymentIntents.createPay.

Die Antwort enthält den Link (seine uri beginnt mit solana:) und seinen QR-Code. Zeige den QR-Code, öffne den Link in der Wallet deines Kunden oder schicke ihn zum gehosteten Checkout: payments.cosmospay.lat, gefolgt von der ID des Links.

API für ZahlungsabsichtenZahlungsabsichten im SDK

Gut zu wissen

• Du kannst den Betrag leer lassen und ihn deinen Kunden wählen lassen, etwa bei Spenden. Ein Link, der deine eigene Gebühr hinzufügt, braucht einen Betrag.
• Eine Nachricht mit bis zu 300 Zeichen, etwa eine Bestellnummer, erscheint in der Wallet deines Kunden.
• Mit deiner eigenen Gebühr auf der Zahlung wird der Link zu einer Solana-Pay-Transaktionsanfrage, die deine Wallet und deine Gebühren-Wallet in einer Transaktion bezahlt.
• Ein Link ist nur eine begrenzte Zeit offen, die der Checkout als Countdown zeigt. Kommt trotzdem noch eine Zahlung an und wird bestätigt, gilt er als bezahlt.
• Die Wallet deines Kunden zahlt die Netzwerkgebühr von Solana in SOL. Jede Zahlung kostet den Satz deines Tarifs, wie in jedem Netzwerk.

Preise und GebührenrechnerStellar vs. Solana vs. Monad