Sellerzy & podział

Split API

Wewnętrzne centrum do organizacji integracji podziału między uczestników, od rejestracji sellerów po uzgodnienie wyniku.

Wymaganie wstępneZidentyfikowani sellerzy
ZastosowaniePodział między wielu uczestników
StanMigracja dokumentacji

Przegląd

Używaj Split, gdy operacja musi kierować kwoty do wielu uczestników w ramach tego samego kontekstu płatności. Implementacja musi wychodzić od wcześniej zidentyfikowanych sellerów i reguł podziału zgodnych z kontraktem operacji.

Uczestnicy

Zidentyfikowani sellerzy.

Każdy odbiorca musi być prawidłowo odwzorowany na platformie.

Reguła

Jawny podział.

Zbuduj skład splitu zgodnie z modelem handlowym i obowiązującym kontraktem.

Uzgadnianie rozliczeń

Zachowane odniesienie.

Zachowaj wewnętrzne identyfikatory, aby uzgadniać zamówienie, transakcję i uczestników.

Przepływ

01 · RejestracjaZidentyfikuj sellerów.

Upewnij się, że każdy uczestnik jest uprawniony do operacji.

02 · RegułaZbuduj podział.

Określ uczestników i kwoty/procenty zgodnie z kontraktem.

03 · PłatnośćUtwórz transakcję.

Przenieś regułę splitu do przepływu zgodnego z API.

04 · FinanseUzgodnij.

Używaj odniesień i zdarzeń, aby śledzić wynik operacji.

Modelowanie

Pole logiczneDo czego służyDobra praktyka
reference_idPowiązanie płatności z Twoim zamówieniem/operacją.Używaj stabilnej, unikalnej wartości.
seller_idIdentyfikacja uczestnika, który otrzyma część operacji.Zweryfikuj sellera przed zbudowaniem splitu.
amount / percentageOdwzorowanie reguły podziału, gdy kontrakt to obsługuje.Unikaj niejednoznacznych zaokrągleń.
metadataUzupełniający kontekst wewnętrzny, gdy jest dostępny.Nie przechowuj sekretów ani zbędnych danych wrażliwych.
Kontrakt ścieżek. Dokładne nazwy pól i endpointów należy przenieść z oficjalnej kolekcji na tę stronę przed ostatecznym usunięciem zewnętrznej referencji.

Lista kontrolna

  • Sellerzy zarejestrowani i uprawnieni do operacji.
  • Reguła podziału zweryfikowana z finansami/sprzedażą.
  • Walidacja sumy kwot/procentów.
  • Wewnętrzne odniesienie zamówienia zachowane.
  • Webhooki połączone z cyklem transakcyjnym.
  • Określone uzgadnianie i obsługa anulowań/zwrotów.

Tymczasowa referencja zewnętrzna

Do czasu zakończenia migracji endpointów używaj kolekcji Postmana do weryfikacji kontraktu technicznego.

Otwórz kolekcję techniczną ↗