IOPAY→Entwickler→Split API
Sellers & Verteilung

Split API

Ein internes Zentrum, das die Verteilung zwischen Teilnehmern von der Verkäuferliste bis zur Ergebniskonzentration organisiert.

VorbedingungSellers identifiziert
VerwendungMehrteilnehmerverteilung
StaatMigration von Unterlagen
Einbindungsmodell Checkliste Sellers →
Übersicht

Übersicht

Verwenden Sie Split, wenn eine Operation Werte an mehrere Teilnehmer innerhalb eines gleichen Zahlungskontexts steuern muss. Die Umsetzung muss sich auf vorher identifizierte Verkäufer und Vertriebsregeln stützen, die mit dem Auftragsvertrag übereinstimmen.

Teilnehmer

Sellers identifiziert.

Jedes Ziel muss auf der Plattform richtig dargestellt werden.

Regel

Erklärliche Verteilung.

Erstellen Sie die Zusammensetzung des Splits nach dem Geschäftsmodell und dem Vertrag.

Abstimmung

Verhaltene Referenz.

Halten Sie interne IDs, um Anfrage, Transaktion und Teilnehmer zu vereinbaren.

Einbindungsmodell

Durchfluss

01 · RegistrierungIdentifizieren Sie die Verkäufer.

Stellen Sie sicher, dass jeder Teilnehmer für die Operation qualifiziert ist.

02 · RegelSetzen Sie die Verteilung an.

Definieren Sie Teilnehmer und Werte/Prozentwerte gemäß dem Vertrag.

03 · ZahlungErstellen Sie die Transaktion.

Bringt die Split-Regel zum API-kompatiblen Fluss.

04 · FinanzielleReconcilie.

Verwenden Sie Referenzen und Ereignisse, um das Ergebnis der Operation zu verfolgen.

Empfohlene Struktur

Modellierung

Logische FeldWas ist der Sinn?Gute Praxis
reference_idZahlung mit Ihrem Antrag/Aufwand korrelieren.Verwenden Sie einen stabilen, einmaligen Wert.
seller_idIdentifizieren Sie den Teilnehmer, der einen Teil der Operation erhalten wird.Validieren Sie seller vor dem Aufbau des Splits.
amount / percentageDie Verteilungsschrift darzustellen, wenn sie durch den Vertrag unterstützt wird.Vermeide unklaren Rundungen.
metadataErgänzender interner Kontext, wenn verfügbar.Sie speichern keine unnötigen Geheimnisse oder sensible Daten.
- Streckenabkommen. Die genauen Feld- und Endpunktanamen müssen von der offiziellen Sammlung auf diese Seite migriert werden, bevor die Außenreferenz endgültig entfernt wird.
Checkliste

Checkliste

  • Sellers die für die Operation registriert und berechtigt sind.
  • Verteilungsschutzregel mit finanzieller/kommerzieller Bestätigung.
  • Validierung der Summe von Werten/Prozent.
  • Inneres Referenzverfahren für die Aufbewahrung.
  • Webhooks, die mit dem Transaktionszyklus verbunden sind.
  • Vermittlung und Behandlung von definierten Stornierungen/Rückweisungen.
Migration der Unterlagen

Zeitlanger Außenreferenz

Solange die Endpunktimigration nicht abgeschlossen ist, verwenden Sie die Postman-Kollektion, um den technischen Vertrag zu überprüfen.

Eröffnen Sie die technische Sammlung —