Seller & Verteilung

Split API

Interne Zentrale zur Organisation der Integration der Verteilung zwischen Beteiligten, von der Seller-Registrierung bis zur Abstimmung des Ergebnisses.

VoraussetzungIdentifizierte Seller
VerwendungVerteilung auf mehrere Beteiligte
StatusMigration der Dokumentation

Überblick

Nutzen Sie Split, wenn ein Vorgang Beträge innerhalb desselben Zahlungskontexts an mehrere Beteiligte leiten muss. Die Implementierung muss von zuvor identifizierten Sellern und Verteilungsregeln ausgehen, die mit dem Vertrag des Vorgangs vereinbar sind.

Beteiligte

Identifizierte Seller.

Jedes Ziel muss auf der Plattform korrekt abgebildet sein.

Regel

Explizite Verteilung.

Gestalten Sie die Split-Zusammensetzung entsprechend dem Geschäftsmodell und dem geltenden Vertrag.

Abstimmung

Referenz erhalten.

Behalten Sie interne IDs, um Bestellung, Transaktion und Beteiligte abzustimmen.

Ablauf

01 · RegistrierungSeller identifizieren.

Stellen Sie sicher, dass jeder Beteiligte für den Vorgang berechtigt ist.

02 · RegelVerteilung zusammenstellen.

Legen Sie Beteiligte und Beträge/Prozentsätze gemäss Vertrag fest.

03 · ZahlungTransaktion erstellen.

Bringen Sie die Split-Regel in den mit der API kompatiblen Ablauf.

04 · FinanzenAbstimmen.

Nutzen Sie Referenzen und Ereignisse, um das Ergebnis des Vorgangs zu verfolgen.

Modellierung

Logisches FeldWofür es dientBest Practice
reference_idZahlung mit Ihrer Bestellung/Ihrem Vorgang verknüpfen.Verwenden Sie einen stabilen, eindeutigen Wert.
seller_idDen Beteiligten identifizieren, der einen Teil des Vorgangs erhält.Prüfen Sie den Seller, bevor Sie den Split zusammenstellen.
amount / percentageDie Verteilungsregel abbilden, sofern vom Vertrag unterstützt.Vermeiden Sie mehrdeutige Rundungen.
metadataErgänzender interner Kontext, sofern verfügbar.Speichern Sie keine Secrets oder unnötigen sensiblen Daten.
Routenvertrag. Die genauen Feld- und Endpunktnamen müssen aus der offiziellen Collection auf diese Seite übertragen werden, bevor die externe Referenz endgültig entfernt wird.

Checkliste

  • Seller registriert und für den Vorgang berechtigt.
  • Verteilungsregel mit Finanzen/Vertrieb abgestimmt.
  • Prüfung der Summe von Beträgen/Prozentsätzen.
  • Interne Bestellreferenz erhalten.
  • Webhooks mit dem Transaktionszyklus verbunden.
  • Abstimmung und Behandlung von Stornierungen/Erstattungen festgelegt.

Vorübergehende externe Referenz

Solange die Migration der Endpunkte nicht abgeschlossen ist, nutzen Sie die Postman-Collection, um den technischen Vertrag zu prüfen.

Technische Collection öffnen ↗