Zum Hauptinhalt springen

Smart-Contract-Integration

Nehmen Sie Krypto-Zahlungen mit den Smart Contracts von Volet.com direkt auf Ihrem eigenen Wallet an. Ihre Kunden verbinden ihre Krypto-Wallets und bestätigen die Transaktionen; der Smart Contract wickelt die Zahlung ab und verteilt Gelder und Bearbeitungsgebühr on-chain.

Weder Sie noch Ihre Kunden benötigen ein Volet.com-Konto. Sie kontrollieren Ihr Empfangs-Wallet und steuern die Zahlungsbestätigung in Ihrer eigenen Anwendung.

Wichtig: Diese Integration nutzt weder Hosted Checkout noch Rechnungen der Merchant API. Ihre Anwendung stellt die Checkout-Oberfläche bereit und prüft Zahlungen direkt auf der Blockchain. Volet.com sendet in diesem Ablauf keine Benachrichtigungen zum Zahlungsstatus.

Funktionsweise​

An einer Non-Custodial-Zahlungsintegration sind drei Komponenten beteiligt:

  • Ihre Anwendung: erstellt Bestellungen, löst Zahlungen aus und prüft Transaktionen.
  • Das Wallet des Kunden: verbindet sich mit Ihrer Anwendung und signiert Zahlungstransaktionen.
  • Der Smart Contract von Volet.com: wickelt Zahlungen ab, überweist die Gelder auf Ihr Wallet und erhebt die Bearbeitungsgebühr.

Zahlungsablauf​

  1. Bestellung erstellen. Ihr Backend speichert Zahlungsbetrag, Asset, Blockchain-Netzwerk und das Empfangs-Wallet des Händlers.
  2. Wallet des Kunden verbinden. Ihre Anwendung fordert die Verbindung eines kompatiblen Krypto-Wallets an.
  3. Zahlung berechnen. Die Smart-Contract-Funktion previewPayment() gibt die Bearbeitungsgebühr und den vom Kunden zu zahlenden Betrag zurück.
  4. Zahlung anfordern. Der Kunde prüft und signiert die Transaktion. Für Token-Zahlungen wie USDT kann vorher eine separate Freigabe nötig sein.
  5. Transaktion wird abgewickelt. Der Smart Contract überweist die Gelder auf Ihr Wallet und erhebt die Bearbeitungsgebühr.
  6. Transaktion speichern. Ihre Anwendung speichert den Transaktions-Hash (txid) und ordnet ihn der Bestellung zu.
  7. Zahlung prüfen. Ihr Backend prüft die Transaktion unabhängig: Status, Netzwerk, Contract, Asset, Empfänger, Betrag und Finalität auf der Blockchain.
  8. Bestellung abschließen. Nach erfolgreicher Prüfung markiert Ihre Anwendung die Bestellung als bezahlt und führt sie genau einmal aus.

Wichtig: Ein Transaktions-Hash, eine Bestätigung im Wallet oder ein erfolgreicher Transaktionsstatus allein belegen nicht, dass eine Bestellung bezahlt ist. Prüfen Sie die Zahlungsdetails immer im Backend, bevor Sie eine Bestellung ausführen.

Netzwerk auswählen​

Wählen Sie die Integrationsanleitung für die Netzwerke und Assets, die Sie annehmen möchten.

NetzwerkAssets in diesen AnleitungenWallets der KundenIntegrationsanleitung
Ethereum und BNB Smart ChainETH, BNB, USDT (ERC-20 und BEP-20)MetaMask und WalletConnect-kompatible WalletsEVM-Integration
TRONTRX, USDT (TRC-20)TronLink; WalletConnect über eine separate IntegrationTRON-Integration

Andere Netzwerke und Assets können eine eigene Implementierung erfordern. Einen Überblick über das Produkt und die verfügbaren Optionen finden Sie unter Non-Custodial-Krypto-Zahlungen akzeptieren.

Bevor Sie beginnen​

Sie benötigen:

  • Händler-Wallet: ein Krypto-Wallet unter Ihrer Kontrolle, um Zahlungen zu empfangen.
  • Anwendung: eine Website oder Anwendung mit Checkout-Oberfläche.
  • Backend und Datenbank: um Bestellungen zu erstellen, Transaktionsdaten zu speichern und Zahlungen zu prüfen.
  • Wallet-Integration: eine Bibliothek zur Wallet-Verbindung, die mit dem gewählten Netzwerk kompatibel ist.
  • Smart-Contract-Daten: die Adressen der Prozessor-Contracts, die ABI und die Parameter von Volet.com.
  • Blockchain-Zugang: einen RPC-Anbieter oder gehosteten Blockchain-Dienst, um Transaktionen zu prüfen.

Je nach Integration benötigen Sie außerdem eine WalletConnect Project ID oder einen TronGrid-API-Schlüssel.

Kontaktieren Sie unser Team, um die Smart-Contract-Daten zu erhalten und Ihre Integration zu besprechen.

Bearbeitungsgebühren​

Der Smart Contract berechnet die Bearbeitungsgebühr über previewPayment(). Ihre Anwendung legt fest, wer sie zahlt:

  • Kunde zahlt: Die Gebühr wird zum Zahlungsbetrag addiert. Der Händler erhält den angeforderten Betrag.
  • Händler zahlt: Die Gebühr wird vom angeforderten Betrag abgezogen. Der Händler erhält den Rest.

Netzwerkgebühren der Blockchain, etwa Gas auf Ethereum oder Energy- und Bandwidth-Kosten auf TRON, fallen zusätzlich zur Bearbeitungsgebühr von Volet.com an.

Verwenden Sie immer die von previewPayment() zurückgegebenen Beträge, statt die Gebühr selbst zu berechnen.

Contract-Parameter und Gebührenberechnung sind in der Smart-Contract-Referenz beschrieben.

Integrationsanleitungen​

So schließen Sie Ihre Integration ab:

  1. Zahlungsablauf umsetzen. Folgen Sie der Anleitung für Ethereum und BNB Smart Chain oder der Anleitung für TRON, um Wallets der Kunden zu verbinden, Smart Contracts zu konfigurieren und Zahlungen zu senden.
  2. Zahlungsprüfung umsetzen. Folgen Sie Zahlungsprüfung und Bestellverfolgung, um Blockchain-Transaktionen Bestellungen zuzuordnen und doppelte Ausführungen zu verhindern.
  3. Integration testen. Testen Sie vor dem Start erfolgreiche und fehlgeschlagene Zahlungen, Token-Freigaben, abgelehnte Transaktionen und die Zahlungsprüfung.

Weitere Ressourcen:

Integrationsbeispiele​

Die Anleitungen für die einzelnen Netzwerke enthalten HTML-Beispiele, die Sie im Browser öffnen oder herunterladen können:

  • EVM-Beispiel (example-evm.html): Wallet-Verbindung, Gebührenberechnung, Zahlungen in ETH, BNB und USDT sowie Transaktionsverfolgung.
  • TRON-Beispiel (example-tron.html): TronLink-Verbindung, Gebührenberechnung, Zahlungen in TRX und USDT sowie Transaktionsverfolgung.

Jede Anleitung erklärt, wie Sie ihr Beispiel verwenden.

Wichtig: Beide Beispiele nutzen Contracts im Mainnet. Jede im Wallet bestätigte Zahlung bewegt echtes Geld. Zum Testen von Zahlungen benötigen Sie zwei Wallets: eines zum Senden und eines zum Empfangen.

Grenzen der Demo: Die Beispiele speichern den Transaktionsverlauf im localStorage des Browsers. Sie enthalten weder ein produktives Backend noch eine vollständige Zahlungsprüfung. Passen Sie sie an und testen Sie sie, bevor Sie echte Kundenzahlungen annehmen.

Mit einem KI-Programmierassistenten integrieren​

Ein KI-Programmierassistent kann Ihnen helfen, Smart-Contract-Zahlungen von Volet.com in Ihre bestehende Anwendung zu integrieren.

Nutzen Sie unseren einsatzbereiten Integrations-Prompt. Er deckt Wallet-Verbindung, Zahlungsabwicklung, Prüfung im Backend, Bestellverfolgung und Tests ab.

Geben Sie Ihrem KI-Assistenten den Prompt, den Quellcode Ihrer Anwendung und die passenden Integrationsanleitungen.

Wichtig: Prüfen und testen Sie sämtlichen KI-generierten Code, bevor Sie echte Zahlungen abwickeln. Kontrollieren Sie Contract-Adressen, Logik der Zahlungsprüfung und Transaktionsverarbeitung.