Überblick

Solana Pay ist ein Standardprotokoll und eine Reihe von Referenzimplementierungen, die es Entwicklern ermöglichen, dezentrale Zahlungen in ihre Apps und Dienste zu integrieren. Es bietet einen einheitlichen Ansatz für Zahlungen im gesamten Solana-Ökosystem und gewährleistet die Kompatibilität zwischen Wallets, Apps und Diensten.

Protokollüberblick

Solana Pay definiert zwei Haupttypen von Zahlungsanforderungen:

Überweisungsanforderungen (Nicht-interaktiv)

Überweisungsanforderungen beschreiben einfache SOL- oder SPL-Token-Überweisungen mithilfe von URL-Parametern. Das Wallet kann die Transaktion direkt zusammenstellen und signieren, ohne zusätzliche Serverkommunikation.

solana:recipient?amount=1.5&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Anwendungsfälle:

  • Einfache Zahlungen und Spenden
  • QR-Code-Zahlungen am Point of Sale
  • Zahlungslinks in E-Mails oder Nachrichten
  • Mobile-App-Deep-Linking

Transaktionsanforderungen (Interaktiv)

Transaktionsanforderungen ermöglichen komplexe Interaktionen, indem das Wallet mit einem Server kommuniziert, um beliebige Solana-Transaktionen zusammenzustellen. Dies eröffnet fortgeschrittene Anwendungsfälle, die über einfache Überweisungen hinausgehen.

solana:https://merchant.com/api/payment

Anwendungsfälle:

  • NFT-Prägung am Point of Sale
  • Dynamische Preisgestaltung und Rabatte
  • Mehrstufige DeFi-Transaktionen
  • Integration von Treueprogrammen
  • Individuelle Geschäftslogik

Hauptvorteile

Für Entwickler

  • Standardprotokoll: Eine Implementierung funktioniert mit allen Solana-Wallets
  • Framework-agnostisch: Verwendbar mit jedem Web-Framework oder jeder mobilen Plattform
  • Typsicherheit: Vollständige TypeScript-Unterstützung im JavaScript SDK
  • Flexibel: Von einfachen Überweisungen bis zu komplexen Multi-Instruktions-Transaktionen

Für Nutzer

  • Schnell: Transaktionen werden in unter einer Sekunde bestätigt
  • Günstig: Durchschnittliche Kosten von 0,0005 $ pro Transaktion
  • Sicher: Keine Vermittler oder Drittanbieter-Zahlungsabwickler
  • Universell: Funktioniert mit jedem Solana-Wallet

Für Händler

  • Keine Gebühren: Direkte Zahlungen ohne Bearbeitungsgebühren
  • Echtzeit: Sofortige Abwicklung und Bestätigung
  • Global: Zahlungen von überall auf der Welt akzeptieren
  • Kombinierbar: Integration mit DeFi-Protokollen und NFT-Marktplätzen

Technische Architektur

URL-Schema

Solana Pay verwendet ein benutzerdefiniertes URL-Schema solana:, das über Webbrowser und mobile Betriebssysteme hinweg funktioniert:

  • Web: URLs können als Links verwendet oder in QR-Codes codiert werden
  • Mobil: Deep-Linking-Integration mit Wallet-Apps
  • Desktop: Protokoll-Handler für nahtloses Wallet-Starten

JavaScript SDK

Das @solana/pay SDK (basierend auf @solana/kit) bietet:

  • Client-Factories: createMerchantClient, createWalletClient, createSolanaPayClient für kombinierbare Zahlungsabläufe
  • URL-Codierung/-Parsing: encodeURL, parseURL für Solana Pay URLs
  • Transfer-Erstellung: createTransfer für SOL- und SPL-Token-Zahlungs- Anweisungen
  • Zahlungsvalidierung: findReference, validateTransfer, watchReference zur Erkennung und Verifizierung von Zahlungen
  • QR-Codes: Integriertes createQR zur Generierung scannbarer Zahlungscodes
  • Kit-Plugins: solanaPayMerchant(), solanaPayWallet() zur Kombination mit anderen @solana/kit-Plugins

Wallet-Integration

Unterstützende Wallets implementieren:

  • URL-Schema-Verarbeitung und -Parsing
  • Transaktionszusammensetzung und -validierung
  • Benutzerbestätigungsabläufe
  • Transaktionsübertragung und -überwachung

Beispiele für Zahlungsabläufe

Web-App zu Mobile Wallet

  1. Web-App generiert QR-Code mit Solana Pay URL
  2. Benutzer scannt QR-Code mit Wallet-App
  3. Wallet analysiert URL und zeigt Zahlungsdetails an
  4. Benutzer bestätigt Zahlung im Wallet
  5. Wallet signiert und sendet Transaktion
  6. Web-App erkennt Zahlungsbestätigung

Web-App zu Browser-Wallet

  1. Web-App zeigt "Mit Solana bezahlen"-Schaltfläche an
  2. Benutzer klickt auf Schaltfläche, um Wallet zu starten
  3. Wallet-Erweiterung zeigt Zahlungsbestätigung an
  4. Benutzer genehmigt Transaktion
  5. Transaktion wird signiert und gesendet
  6. Web-App erhält Zahlungsbestätigung

Mobile App zu Mobile Wallet

  1. Mobile App erstellt Payment-Deep-Link
  2. Deep-Link startet Wallet-App
  3. Wallet zeigt Zahlungsbestätigung an
  4. Benutzer genehmigt oder lehnt Zahlung ab
  5. Wallet kehrt zur ursprünglichen App zurück
  6. App erhält Zahlungsergebnis

Sicherheitsaspekte

Für Händler

  • Transaktionen validieren: Transaktionsdetails immer On-Chain verifizieren
  • Referenzen verwenden: Eindeutige Referenzschlüssel zur Identifizierung von Zahlungen einbinden
  • Server-seitige Validierung: Beträge berechnen und Zahlungen server-seitig validieren
  • Rate Limiting: Angemessene Rate Limits für Payment-Endpunkte implementieren

Für Wallet-Entwickler

  • URL-Validierung: Alle URL-Komponenten validieren und bereinigen
  • Benutzerbestätigung: Zahlungsdetails dem Benutzer immer klar anzeigen
  • Transaktionsvalidierung: Transaktionsinhalte vor dem Signieren verifizieren
  • Nur HTTPS: Ausschließlich HTTPS-URLs für Transaktionsanfragen zulassen

Integrationsmuster

E-Commerce-Checkout

  1. Kunde fügt Artikel zum Warenkorb hinzu
  2. Händler generiert Zahlungsanfrage mit Bestelldetails
  3. Kunde scannt QR-Code oder klickt auf Zahlungs-Button
  4. Wallet zeigt aufgeschlüsselte Quittung und Gesamtbetrag an
  5. Kunde bestätigt Zahlung
  6. Händler validiert Transaktion und erfüllt Bestellung

Point of Sale

  1. Kassierer gibt Verkaufsbetrag ein
  2. POS-System zeigt QR-Code an
  3. Kunde scannt mit Mobile Wallet
  4. Zahlung wird sofort verarbeitet
  5. Quittung wird automatisch gedruckt

Abonnement-Services

  1. Benutzer abonniert Service
  2. Service erstellt wiederkehrenden Zahlungsplan
  3. Automatisiertes System generiert Zahlungsanfragen
  4. Benutzer genehmigt Zahlungen über Wallet
  5. Service verfolgt Zahlungsstatus

Best Practices

URL-Generierung

  • HTTPS für alle Transaktionsanfrage-Endpunkte verwenden
  • Aussagekräftige Labels und Nachrichten einbinden
  • Eindeutige Referenzen für Payment-Tracking generieren
  • Alle Parameter vor URL-Erstellung validieren

Transaktionsabwicklung

  • Validieren Sie Transaktionen immer serverseitig
  • Verwenden Sie angemessene Bestätigungszähler für die Sicherheit
  • Implementieren Sie ordnungsgemäße Fehlerbehandlung und Wiederholungsversuche
  • Protokollieren Sie Zahlungsereignisse zur Abstimmung

Benutzererfahrung

  • Bieten Sie klare Zahlungsbestätigungen
  • Zeigen Sie Transaktionsstatusaktualisierungen an
  • Behandeln Sie Wallet-Verbindungen sorgfältig
  • Unterstützen Sie mehrere Wallet-Optionen

Nächste Schritte

Bereit, Solana Pay zu integrieren? Beginnen Sie mit diesen Anleitungen:

Ressourcen

Is this page helpful?

Verwaltet von

© 2026 Solana Foundation.
Alle Rechte vorbehalten.
Verbinden Sie sich