Zum Hauptinhalt springen

Smart-Contract-Integration

Eine typische Non-Custodial-Zahlungsintegration besteht aus drei Komponenten:

  • Ihrer Anwendung
  • Einem Wallet-Verbindungsanbieter
  • Dem Zahlungs-Smart-Contract

Der Wallet-Verbindungsanbieter verbindet lediglich das Wallet des Kunden und fordert die Signatur der Transaktion an. Die Zahlung selbst führt der Smart Contract auf der Blockchain aus.

tipp

Kontaktieren Sie unser Team, bevor Sie mit der Integration beginnen. Wir stellen Ihnen die erforderlichen Smart-Contract-Daten und die ABI bereit und helfen Ihnen, die passende Architektur für Ihre Anwendung zu wählen.

Zahlungsablauf​

  1. Der Kunde gelangt auf Ihre Checkout-Seite.
  2. Der Kunde verbindet sein Wallet.
  3. Ihre Anwendung bereitet eine Zahlungstransaktion vor.
  4. Die Transaktion wird an das verbundene Wallet übergeben.
  5. Der Kunde prüft und signiert die Transaktion.
  6. Das Wallet sendet die signierte Transaktion an die Blockchain.
  7. Der Smart Contract überträgt das Geld.
  8. Das Wallet erhält einen Transaktions-Hash (txid) und gibt ihn an Ihre Anwendung zurück.
  9. Ihre Anwendung verfolgt die Transaktion, bis sie den erforderlichen Bestätigungsstatus erreicht.
  10. Ihr System markiert die Bestellung als bezahlt.

Voraussetzungen​

Für die Integration benötigen Sie:

  • Eine Frontend-Anwendung, die Krypto-Wallets verbinden kann.
  • Ein Backend (empfohlen), um Zahlungsanfragen zu erstellen und Blockchain-Transaktionen zu verfolgen.
  • Die von Volet.com bereitgestellten Smart-Contract-Daten.
  • Einen Wallet-Verbindungsanbieter, der zu den Blockchain-Netzwerken passt, die Sie unterstützen möchten.

Einmalige Einrichtung​

Schritt 1. Wallet-Verbindung einrichten​

Integrieren Sie einen Wallet-Verbindungsanbieter, der zu den Blockchain-Netzwerken passt, die Sie unterstützen möchten.

Typische Optionen:

  • WalletConnect – Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche und andere EVM-kompatible Netzwerke.
  • TronLink – Tron.
  • TON Connect – TON.
  • Solana Wallet Adapter – Solana.

Manche Anbieter, etwa WalletConnect, erfordern vor der Nutzung eine Project ID oder API-Zugangsdaten.

Schritt 2. Smart-Contract-Daten anfordern​

Wenden Sie sich an Volet.com, um die Smart-Contract-Adresse, die ABI und eventuelle integrationsspezifische Parameter zu erhalten.

Umsetzung des Zahlungsablaufs​

Schritt 1. Wallet des Kunden verbinden​

Fordern Sie den Kunden auf, ein kompatibles Wallet zu verbinden.

Zum Beispiel:

  • MetaMask oder Trust Wallet über WalletConnect.
  • TronLink für Tron.
  • Tonkeeper über TON Connect.
  • Phantom oder Solflare über Solana Wallet Adapter.

Schritt 2. Transaktion vorbereiten​

Bereiten Sie in Ihrer Anwendung eine Transaktionsanfrage vor.

Sie enthält in der Regel:

  • Wallet-Adresse des Empfängers
  • Zahlungsbetrag
  • Token
  • Blockchain-Netzwerk (chainId)
  • Bestell-ID
  • Optionale Metadaten

Die Transaktion kann im Frontend oder im Backend vorbereitet werden.

Schritt 3. Signatur der Transaktion anfordern​

Übergeben Sie die vorbereitete Transaktion an das verbundene Wallet.

Anhand der angegebenen chainId wählt das Wallet automatisch das passende Blockchain-Netzwerk und den RPC-Endpunkt.

Der Kunde prüft die Transaktionsdetails.

Ist alles korrekt, signiert er die Transaktion in seinem Wallet.

Schritt 4. Transaktion senden​

Nach der Signatur sendet das Wallet die Transaktion über den passenden RPC-Endpunkt an die Blockchain.

Akzeptiert das Netzwerk die Transaktion, erhält das Wallet einen Transaktions-Hash (txid) und gibt ihn an Ihre Anwendung zurück.

Speichern Sie den Transaktions-Hash zusammen mit Ihrer Bestellung.

Schritt 5. Transaktionsbestätigungen prüfen​

Überwachen Sie die Blockchain anhand des Transaktions-Hashs, bis die Zahlung den erforderlichen Bestätigungsstatus erreicht.

Sobald die Transaktion ausreichend bestätigt ist, markieren Sie die Bestellung in Ihrem System als bezahlt.

RPC-Anbieter​

Die Wallets der Kunden wählen anhand der chainId der Transaktion automatisch einen RPC-Endpunkt – für einfache Integrationen ist keine zusätzliche Konfiguration nötig.

Wenn Ihre Anwendung sehr viele Blockchain-Anfragen stellt – etwa um Zahlungstransaktionen zu überwachen oder Blockchain-Daten in großem Umfang abzufragen –, sollten Sie Folgendes in Betracht ziehen:

  • Einen dedizierten RPC-Anbieter.
  • Einen eigenen RPC-Knoten.

Dedizierte Infrastruktur hilft, die Anfragelimits öffentlicher RPC-Endpunkte zu umgehen, und erhöht die Zuverlässigkeit unter hoher Last.

Wie geht es weiter​

  • Lesen Sie die Smart-Contract-Referenz.
  • Testen Sie erfolgreiche und fehlgeschlagene Zahlungen.
  • Prüfen Sie die Verarbeitung der Transaktionsbestätigungen.
  • Gehen Sie in die Produktion.