Zum Hauptinhalt springen

Zahlungs-Gateway erstellen

Für Custodial-Zahlungs-Gateways benötigen Sie ein verifiziertes Volet.com-Konto. Falls Sie noch keines haben, lesen Sie Konto erstellen, Unternehmensverifizierung oder Persönliche Verifizierung.

Non-Custodial-Zahlungsintegrationen erfordern kein Volet.com-Konto. Kontaktieren Sie unser Team für Details zur Integration.

Integrationsmethode wählen​

  • Wählen Sie Hosted Checkout für die schnellste Integration mit einer fertigen, von Volet.com gehosteten Zahlungsseite. Dies ist zudem die einzige Integrationsmethode, die Zahlungen vom Guthaben eines Volet.com-Kontos unterstützt.
  • Wählen Sie die API, wenn Sie Ihren eigenen Zahlungsablauf aufbauen und das Kundenerlebnis vollständig steuern möchten.

Vergleichen Sie API, Hosted Checkout und Smart Contracts, um die passende Integrationsmethode für Ihr Unternehmen zu wählen.

hinweis

Sie können diese Einstellungen nach dem Erstellen des Gateways jederzeit ändern.

Option 1: Hosted-Checkout-Gateway erstellen​

Schritt 1: Hosted Checkout erstellen​

Melden Sie sich in Ihrem Volet.com-Dashboard an, öffnen Sie Zahlungstools und klicken Sie im Bereich Hosted Checkout auf Erstellen.

Schritt 2: Zahlungsmethoden konfigurieren​

Aktivieren Sie im ersten Tab die Zahlungsmethoden, die Sie akzeptieren möchten:

MethodeBeschreibung
Volet.com-NutzerKunden bezahlen von ihrem Volet.com-Konto.
Krypto-WalletsKunden bezahlen in BTC, ETH, USDT, USDC und anderen unterstützten Token aus einem beliebigen Krypto-Wallet.

Mehr zu den einzelnen Methoden:

Legen Sie für jede Methode Wer zahlt die Gebühr fest: ob die Bearbeitungsgebühr vom empfangenen Betrag abgezogen (Händler zahlt) oder dem Kunden aufgeschlagen wird (Käufer zahlt).

Schritt 3: Einstellungen konfigurieren​

Konfigurieren Sie Ihre Hosted-Checkout-Seite und die Callback-URLs.

Optionen der Zahlungsverarbeitung​

  1. Digitale Signatur in Hosted-Checkout-Anfragen verwenden.

    Signiert Zahlungsanfragen und Callback-Benachrichtigungen mit Ihrem Hosted-Checkout-Passwort. So lässt sich prüfen, dass Anfragen von Volet.com stammen und bei der Übertragung nicht verändert wurden.

    Wir empfehlen, diese Option in Produktivumgebungen aktiviert zu lassen.

  2. Unterzahlung akzeptieren.

    Erlaubt den Abschluss von Bestellungen, wenn der Kunde weniger als den angeforderten Betrag sendet.

    Diese Option kann bei Krypto-Zahlungen nützlich sein, wenn Netzwerkgebühren, manuelle Berechnungen oder Wechselkursschwankungen zu einer etwas geringeren Zahlung als erwartet führen.

  3. Überzahlung akzeptieren.

    Erlaubt den Abschluss von Bestellungen, wenn der Kunde mehr als den angeforderten Betrag sendet.

    Diese Option kann nützlich sein, wenn Kunden versehentlich einen höheren Betrag überweisen.

Hosted-Checkout-Konfiguration​

  1. Name des Hosted Checkout. Name, mit dem dieser Hosted Checkout in Ihrem Volet.com-Konto gekennzeichnet wird.

  2. URL der Website, mobilen App, des Bots oder KI-Agenten. Geben Sie die öffentliche URL an, die zu diesem Zahlungs-Gateway gehört. Diese URL wird Kunden auch während des Zahlungsvorgangs angezeigt.

Beispiele:

  1. Benachrichtigungs-E-Mail. Optionale E-Mail-Adresse, die Benachrichtigungen über Transaktionen dieser Hosted-Checkout-Konfiguration erhält.

  2. Im Hosted Checkout angezeigte E-Mail. Für zukünftige Verwendung reserviert.

  3. Hosted-Checkout-Passwort. Geheimer Schlüssel zum Signieren von Zahlungsanfragen und zum Prüfen von Callback-Benachrichtigungen. Halten Sie ihn geheim und legen Sie ihn nicht im clientseitigen Code offen.

Konfiguration der Status-URLs​

Konfigurieren Sie anschließend die Callback- und Weiterleitungs-URLs. Sie können diese Parameter weglassen und/oder im Zahlungsanfrageformular angeben.

  1. Success URL. URL, auf die Kunden nach einer erfolgreichen Zahlung weitergeleitet werden.

  2. Failed URL. URL, auf die Kunden weitergeleitet werden, wenn die Zahlung fehlschlägt oder abgebrochen wird.

  3. Status URL. Server-Endpunkt, der Benachrichtigungen zum Zahlungsstatus empfängt. Nutzen Sie diese Benachrichtigungen, um Bestellstatus in Ihrem System automatisch zu aktualisieren.

Für Success URL, Failed URL und Status URL können Sie die HTTP-Methode wählen:

  • GET – Parameter werden im Query-String gesendet.
  • POST – Parameter werden im Request-Body gesendet.

Schritt 4: Erscheinungsbild anpassen (optional)​

Optional, kann später eingerichtet werden.

Sie können die Hosted-Checkout-Seite mit Ihrem Logo und Ihren Markenfarben gestalten.

Schritt 5: Freigabe​

Neu erstellte Gateways müssen von einem Administrator freigegeben werden, bevor sie echte Zahlungen annehmen können.

Die Freigabe dauert in der Regel einige Stunden.

Sie erhalten eine E-Mail, sobald Ihr Gateway freigegeben und einsatzbereit ist.

hinweis

Vor der Freigabe des Gateways können Sie keine echten Zahlungen verarbeiten. Nutzen Sie die Zeit, um die Integration auf Ihrer Website abzuschließen.

Schritt 6: Hosted Checkout integrieren​

Nach der Freigabe können Sie Hosted Checkout in Ihre Website, App, Ihren Bot oder KI-Agenten integrieren.

Siehe: Hosted-Checkout-Integration

Option 2: API-Gateway erstellen​

Schritt 1: API-Gateway erstellen​

Melden Sie sich in Ihrem Volet.com-Dashboard an, öffnen Sie Zahlungstools und klicken Sie im Bereich API auf Erstellen.

Schritt 2: API-Einstellungen konfigurieren​

Konfigurieren Sie die grundlegenden API-Einstellungen.

  1. API-Name. Interner Name des API-Gateways. Er wird nur in Ihrem Volet.com-Konto verwendet.

  2. IP-Whitelist. Liste der IP-Adressen, die auf die API zugreifen dürfen.

    Sie können:

    • Eine oder mehrere IP-Adressen manuell eingeben.
    • Auf Aktuelle IP hinzufügen klicken, um Ihre aktuelle IP-Adresse automatisch hinzuzufügen.
    • Alle IPs zulassen aktivieren, um IP-Beschränkungen aufzuheben (für Produktivumgebungen nicht empfohlen).

  3. API-Passwort. Geheimer Schlüssel zur Authentifizierung von API-Anfragen. Halten Sie ihn geheim und legen Sie ihn nicht im clientseitigen Code offen.

  4. URL der Website, mobilen App, des Bots oder KI-Agenten. Geben Sie die öffentliche URL an, die zu dieser API-Integration gehört.

Beispiele:

  1. Benachrichtigungs-E-Mail. Optionale E-Mail-Adresse, die Benachrichtigungen über Transaktionen dieses API-Gateways erhält.

Schritt 3: API-Berechtigungen konfigurieren​

Wählen Sie, welche Berechtigungen für dieses API-Gateway verfügbar sind.

Für Integrationen zur Zahlungsannahme aktivieren Sie:

  • Transaktionen ausführen
    • Krypto-Zahlungen akzeptieren – erlaubt Ihrer Anwendung, Zahlungsrechnungen zu erstellen und Krypto-Zahlungen aus Krypto-Wallets anzunehmen.
  • Transaktion suchen – erlaubt Ihrer Anwendung, nach dem Erstellen einer Rechnung den Zahlungsstatus und die Transaktionsdetails abzurufen.

API-Integrationen verwenden keine Callback-URLs. Nach dem Erstellen einer Rechnung sollte Ihre Anwendung Transaktion suchen nutzen, um den aktuellen Zahlungsstatus abzufragen.

Weitere Berechtigungen wie Guthabenabfrage, Transaktionsverlauf, Umtausch und Auszahlungen können Sie später aktivieren, wenn Ihre Integration sie benötigt. Details finden Sie in der API-Referenz.

Schritt 4: Freigabe​

Neu erstellte API-Gateways müssen von einem Administrator freigegeben werden, bevor sie echte Transaktionen verarbeiten können.

Die Freigabe dauert in der Regel einige Stunden.

Sie erhalten eine E-Mail, sobald Ihr API-Gateway freigegeben und einsatzbereit ist.

hinweis

Vor der Freigabe des API-Gateways können Sie keine echten Transaktionen verarbeiten.

Schritt 5: Integrieren​

Nach der Freigabe können Sie Zahlungen über die API annehmen.

Siehe:

  • API-Integration – Anleitung zur Integration eines API-Zahlungs-Gateways.
  • API-Referenz – vollständige Dokumentation der Methoden, Parameter und Antworten.