Zum Hauptinhalt springen

Sub-Händler

Nehmen Sie mit einer einzigen Volet.com-Integration Zahlungen im Namen mehrerer Händler an.

Mit der Sub-Händler-Unterstützung können Plattformen eigene Zahlungsprodukte auf Basis von Volet.com aufbauen. Statt jeden Händler direkt bei Volet.com anzumelden, integriert sich die Plattform einmalig und wickelt Zahlungen im Namen ihrer eigenen Händler ab.

Kunden bezahlen weiterhin über Ihre Plattform oder Ihre Sub-Händler, während Ihre Plattform der einzige Integrationspunkt zu Volet.com bleibt.

Jede Zahlung lässt sich einem bestimmten Sub-Händler zuordnen. So kann die Plattform die Zahlung identifizieren, Bestellungen verfolgen und die Abrechnung nach ihrer eigenen Geschäftslogik steuern.

Typische Anwendungsfälle:

  • White-Label-Zahlungsanbieter
  • Händler-Aggregatoren
  • Marktplätze
  • Creator-Plattformen
  • SaaS-Plattformen mit mehreren Händlern

So funktioniert es​

Eine Plattform integriert Volet.com einmalig und nimmt Zahlungen im Namen mehrerer Sub-Händler an.

Der allgemeine Zahlungsablauf:

  1. Ihre Plattform erstellt eine Zahlungsanfrage im Namen eines Sub-Händlers.
  2. Ihre Plattform fügt der Zahlungsanfrage die Sub-Händler-Informationen hinzu.
  3. Der Kunde schließt die Zahlung über Hosted Checkout, Ihre eigene API-basierte Zahlungsoberfläche oder einen Smart-Contract-Ablauf ab.
  4. Das Geld wird gemäß dem gewählten Zahlungsmodell empfangen.
  5. Ihre Plattform ordnet die abgeschlossene Zahlung der entsprechenden Sub-Händler-Bestellung zu.
  6. Ihre Plattform rechnet mit dem Sub-Händler nach ihren eigenen kommerziellen Bedingungen ab.

Integrationsmodelle​

Die Sub-Händler-Unterstützung ist mit verschiedenen Integrationsmodellen verfügbar.

Hosted Checkout​

Hosted Checkout bietet ein fertiges Zahlungserlebnis und ermöglicht Ihrer Plattform zugleich, jede Zahlung einem bestimmten Sub-Händler zuzuordnen.

Beim Erstellen einer Hosted-Checkout-Zahlungsanfrage können Sie die Website des Sub-Händlers im Parameter ac_submerchant_url übergeben.

Beispiel:

<input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

Sie können auch benutzerdefinierte Felder mitsenden, zum Beispiel:

  • Sub-Händler-ID
  • Verkäufer-ID
  • Bestell-ID des Marktplatzes
  • Interne Rechnungsnummer
  • Kunden-ID

Diese Werte werden unverändert in Statusbenachrichtigungen und Kundenweiterleitungen zurückgegeben, sodass Ihre Plattform abgeschlossene Zahlungen dem richtigen Sub-Händler und der richtigen Bestellung zuordnen kann.

Details unter Hosted-Checkout-Integration.

API mit Hosted Checkout​

API und Hosted Checkout lassen sich in einem Zahlungsablauf kombinieren.

Die API erstellt die Zahlungsrechnung, Hosted Checkout stellt die Zahlungsoberfläche für den Kunden bereit.

In diesem Modell erstellt Ihre Plattform über die API eine Krypto-Rechnung und ordnet sie einer Sub-Händler-Bestellung zu, bevor der Kunde zu Hosted Checkout weitergeleitet wird.

Anders als im Standardablauf von Hosted Checkout wird die Zahlungsrechnung von Ihrer Plattform erstellt und nicht von Hosted Checkout. Hosted Checkout zeigt lediglich die Zahlungsseite für die vorhandene Rechnung an und steuert das Zahlungserlebnis des Kunden.

Mit diesem Ansatz kann Ihre Plattform:

  • Die Zahlung einem Sub-Händler zuordnen, bevor der Kunde mit der Zahlung beginnt.
  • Ihre eigene Bestell- und Rechnungslogik beibehalten.
  • Darauf verzichten, eine Zahlungsoberfläche für sich selbst oder ihre Sub-Händler zu entwickeln und zu pflegen.
  • Zahlungsanweisungen, QR-Codes, Blockchain-Überwachung und Statusaktualisierungen Volet.com überlassen.

Ohne Hosted Checkout lässt sich derselbe Ablauf vollständig über die API umsetzen. Dann muss Ihre Plattform oder jeder Sub-Händler eine eigene Zahlungsoberfläche für Kunden bereitstellen.

Nach Abschluss der Zahlung empfängt oder prüft Ihre Plattform den Zahlungsstatus und ordnet die Zahlung anhand der Rechnungs- oder Bestellreferenz dem entsprechenden Sub-Händler zu.

Siehe:

Smart-Contract-Zahlungen​

Plattformen können Sub-Händler auch mit Non-Custodial-Smart-Contract-Zahlungen unterstützen.

In diesem Modell bezahlen Kunden direkt aus ihren Wallets, und die Zahlung wird von einem Smart Contract on-chain ausgeführt.

Anders als bei Custodial-Abläufen lässt sich die Abrechnungslogik direkt im Smart Contract umsetzen. So kann jede Zahlung im Moment ihrer Ausführung automatisch zwischen der Plattform und einem oder mehreren Sub-Händlern aufgeteilt werden.

Typische Anwendungsfälle:

  • Umsatzbeteiligung
  • Verteilung von Marktplatz-Provisionen
  • Zahlungen an mehrere Empfänger
  • Direkte Abrechnung von Wallet zu Wallet
  • Individuelle Zahlungslogik

Details unter Umsatzbeteiligung.

Sub-Händler-Zahlungen nachverfolgen​

Verknüpfen Sie jede Zahlung mit Ihren eigenen Kennungen, damit sie dem entsprechenden Sub-Händler und der Bestellung zugeordnet werden kann.

Gängige Kennungen:

  • Sub-Händler-ID
  • Website des Sub-Händlers
  • Bestell-ID des Marktplatzes
  • Interne Rechnungs-ID
  • Kunden-ID
  • ID des Abrechnungsstapels

Bei Hosted Checkout können Sie den Parameter ac_submerchant_url und benutzerdefinierte Felder verwenden.

Bei API-basierten Krypto-Rechnungsabläufen speichern Sie die ID der Krypto-Rechnung zusammen mit der Bestellung Ihrer Plattform und dem Datensatz des Sub-Händlers.

Bei Smart-Contract-Abläufen kann Ihre Anwendung je nach gewählter Smart-Contract-Architektur Transaktionsmetadaten, Bestellreferenzen oder On-Chain-Ereignisse verwenden.

Abrechnung mit Sub-Händlern​

Bei Custodial-Zahlungsabläufen wird das empfangene Geld dem Volet.com-Konto des Haupthändlers gutgeschrieben.

Nach Abschluss der Zahlung ist der Haupthändler dafür verantwortlich, gemäß seinem eigenen kommerziellen Modell mit dem Sub-Händler abzurechnen.

Für die Abrechnung mit Sub-Händlern gibt es folgende Möglichkeiten:

  • Kryptowährung an ein Krypto-Wallet übertragen.
  • Geld auf das Volet.com-Konto des Sub-Händlers übertragen.
  • Manuell eine Banküberweisung über die Kontooberfläche senden, sofern verfügbar.
hinweis

Banküberweisungen an Sub-Händler sind derzeit nicht über die API verfügbar. Ist eine Abrechnung per Banküberweisung nötig, muss sie manuell über die Kontooberfläche erfolgen.

Ihre Plattform kann vor der Abrechnung des Restbetrags an den Sub-Händler auch ihre eigene Provision abziehen.

Beispiel:

  1. Der Kunde zahlt 100 USDT.
  2. Ihre Plattform empfängt die Zahlung.
  3. Ihre Plattform behält eine Provision von 10 USDT ein.
  4. Ihre Plattform rechnet 90 USDT mit dem Sub-Händler ab.

Compliance und Prüfung​

Die Verarbeitung für Sub-Händler unterliegt einer Prüfung.

Ihre Plattform ist dafür verantwortlich zu wissen, wer ihre Sub-Händler sind, welche Waren oder Dienstleistungen sie anbieten und ob ihre Tätigkeit nach den Richtlinien von Volet.com zulässig ist.

hinweis

Alle Anforderungen an Compliance, verbotene Tätigkeiten und Händlerverifizierung, die für Händler gelten, gelten auch für Sub-Händler.

Volet.com kann vor Aktivierung oder Freigabe der Integration Informationen zu Ihrem Sub-Händler-Modell, Onboarding-Prozess, den Geschäftskategorien, Websites, Transaktionsabläufen und der Abrechnungslogik anfordern.

So aktivieren Sie die Funktion​

Schritt 1. Kontakt aufnehmen​

Die Verarbeitung für Sub-Händler wird individuell eingerichtet. Vereinbaren Sie ein Gespräch mit unserem Vertriebsteam.

Wenden Sie sich an unser Team und beschreiben Sie:

  • Das Modell Ihrer Plattform
  • Die Arten von Sub-Händlern, die Sie unterstützen
  • Die erwarteten Zahlungsmethoden
  • Den erwarteten Abrechnungsablauf

Unser Team hilft Ihnen, das passende Modell zu wählen:

  • Hosted Checkout für ein fertiges Zahlungserlebnis.
  • API mit Hosted Checkout für vorab erstellte Krypto-Rechnungen und die Zahlungsoberfläche von Hosted Checkout.
  • Reine API-Integration, wenn Ihre Plattform eine eigene Zahlungsoberfläche bereitstellt.
  • Smart Contracts für Non-Custodial-Abläufe und individuelle On-Chain-Abrechnungslogik.

Schritt 2. Zahlungsannahme konfigurieren​

Wenn Sie Hosted Checkout, die API oder die API mit Hosted Checkout nutzen, erstellen und konfigurieren Sie ein Zahlungs-Gateway in Ihrem Volet.com-Konto.

Das Gateway legt fest, wie Zahlungen angenommen werden, welche Zahlungsmethoden aktiviert sind und wie Statusinformationen verarbeitet werden.

Siehe:

Wenn Sie einen Smart-Contract-Zahlungsablauf nutzen, stellt Ihnen unser Team stattdessen die erforderliche Smart-Contract-Einrichtung bereit.

Schritt 3. Integration umsetzen​

Setzen Sie den Zahlungsablauf um, der zu Ihrem gewählten Integrationsmodell passt.

Details zur Umsetzung:

Schritt 4. Sub-Händler-Daten und Bestellzuordnung konfigurieren​

Legen Sie fest, wie Ihre Plattform Sub-Händler-Informationen übergibt, speichert und zuordnet.

Schritt 5. Zahlungs- und Abrechnungsabläufe testen​

Testen Sie vor dem Livegang:

  • Erstellung von Zahlungen
  • Identifizierung von Sub-Händlern
  • Verarbeitung des Zahlungsstatus
  • Zuordnung von Bestellungen
  • Berechnung von Provisionen
  • Abrechnung mit Sub-Händlern
  • Fehlgeschlagene und abgebrochene Zahlungen

Schritt 6. Live gehen​

Sobald die Integration freigegeben, konfiguriert und getestet ist, kann Ihre Plattform Zahlungen im Namen von Sub-Händlern annehmen.

Einschränkungen​

  • Ihre Plattform ist für die Abrechnung mit dem Sub-Händler verantwortlich.
  • Die Abrechnung per Banküberweisung an Sub-Händler ist über die API nicht verfügbar.
  • Manche Sub-Händler-Geschäftsmodelle erfordern vor der Aktivierung eine zusätzliche Compliance-Prüfung.