Funkcja Split Payout umożliwia bramce SIBS Gateway podział jednej transakcji pomiędzy maksymalnie cztery różne konta rozliczeniowe.
Ta funkcjonalność jest szczególnie przydatna w modelach biznesowych z wieloma beneficjentami, gdy część kwoty transakcji musi zostać przydzielona różnym podmiotom.
Podczas przetwarzania transakcji, sprzedawcy muszą uwzględnić informacje o Punkcie Rozliczeniowym (Settlement Point) w żądaniach API, aby kwota transakcji została prawidłowo rozdzielona pomiędzy skonfigurowane konta rozliczeniowe.
Korzyści
Funkcjonalność ta przynosi różne korzyści dla merchantów, takie jak:
Ogólnie rzecz biorąc, Split Payout pozwala sprzedawcom skuteczniej zarządzać finansami, zwiększać efektywność operacyjną i zapewniać spójne doświadczenie płatnicze dla wszystkich stron zaangażowanych w transakcję.
Przed rozpoczęciem
Aby korzystać z Split Payout, funkcjonalność musi zostać aktywowana podczas procesu wdrożenia.
Identyfikatory Punktów Rozliczeniowych (Settlement Point IDs) są generowane i konfigurowane podczas aktywacji Split Payout.
Po konfiguracji odpowiednie ID Punktów Rozliczeniowych stają się dostępne w SIBS Backoffice, gdzie sprzedawcy mogą je przeglądać i używać podczas przetwarzania transakcji.
Jak to działa
Krok 1: Zdefiniowanie punktów rozliczeniowych
Krok 2: Odbierz odpowiedź
Krok 3: Wykonaj płatność
Krok 1: Zdefiniowanie punktów rozliczeniowych
Po aktywacji Split Payout, ID Punktów Rozliczeniowych stają się dostępne w SIBS Backoffice.
System backend sprzedawcy powinien pobrać i przechowywać odpowiednie identyfikatory Punktów Rozliczeniowych, aby używać ich podczas przetwarzania transakcji.
Tworząc transakcję checkout z użyciem Split Payout, obiekt musi być uwzględniony w obiekcie transakcji żądania checkout.settlementPoint
Każdy Punkt Rozliczeniowy określa:
- docelowe konto rozliczeniowe;
- kwotę przypisaną do tego konta.
SettlementPoint (tablica) – obowiązkowe dla transakcji Split Payout
Informacje o Punkcie Rozliczeniowym definiują sposób podziału kwoty transakcji pomiędzy konta rozliczeniowe.
Obiekt musi być uwzględniony w obiekcie transakcji żądania checkout.settlementPoint
| Field | Type | Condition | Opis | Example |
|---|---|---|---|---|
| requestBody.transaction.settlementPoint | Array | Mandatory | Lista obiektów Punktów Rozliczeniowych używana do podziału środków transakcji między wiele kont. | – |
| requestBody.transaction.settlementPoint.id | String | Mandatory | Unikalny identyfikator Punktu Rozliczeniowego skonfigurowany podczas wdrożenia, dostępny w SIBS Backoffice. | T13d4f9fb115f54b6cbe6f20a6ae68dbd6 |
| requestBody.transaction.settlementPoint.amount | Object | Mandatory | Informacje o kwocie Punktu Rozliczeniowego. | – |
| requestBody.transaction.settlementPoint.amount.value | number: Double | Mandatory | Kwota przypisana do Punktu Rozliczeniowego. | 2 |
| requestBody.transaction.settlementPoint.amount.currency | currency code: ISO 4217 Alpha-3 Code | Mandatory | Waluta użyta w transakcji. | PLN |
Przykładowe żądanie:
{
"transaction": {
"settlementPoint": [
{
"id": "T13d4f9fb115f54b6cbe6f20a6ae68dbd6",
"amount": {
"value": 2,
"currency": "PLN"
}
},
{
"id": "T23d4f9fb115f54b6cbe6f20a6ae68dbd6",
"amount": {
"value": 2,
"currency": "PLN"
}
}
]
}
}
Krok 2: Odbierz odpowiedź
Odpowiedź zawiera statusMsg, transactionID, transactionSignature oraz listę dostępnych metod płatności (paymentMethodList) które można wyświetlić.
Upewnij się, że zamówienie zostało poprawnie utworzone i przesłane, zanim przejdziesz do płatności.
Krok 3: Wykonaj płatność
Obsługiwane metody płatności
Po utworzeniu i przesłaniu zamówienia checkout zawierającego Punkty Rozliczeniowe, kupujący może kontynuować wybraną metodę płatności.
Dla metod wymagających przekierowania sprzedawca musi kontynuować przepływ płatności przy użyciu odpowiednich API płatności.
Szczegóły metod płatności można znaleźć w sekcji Metody płatności.
Operacje uzupełniające
Dla transakcji przetwarzanych z użyciem Split Payout, te same informacje o Punktach Rozliczeniowych muszą być również uwzględnione w żądaniach operacji uzupełniających, takich jak Authorization, Capture i Purchase.
Dotyczy to:
- operacji Capture utworzonych z Authorization;
- operacji Cancel utworzonych z Authorization;
- operacji Refund utworzonych z Purchase;
- operacji Refund utworzonych z Capture.
Struktura musi odpowiadać formatowi użytemu podczas początkowej transakcji checkout.settlementPoint
Żądania Authorization, Capture, Cancel i Refund związane z transakcjami Split Payout wymagają obecności obiektu , aby zapewnić prawidłowy podział środków.settlementPoint
Monitoring i raportowanie
Punkty Rozliczeniowe skonfigurowane dla każdego sklepu można przeglądać w SIBS Backoffice w sekcji Configuration > Split Payouts.
Szczegóły transakcji i przypisane kwoty do Punktów Rozliczeniowych dostępne są w Business > Transactions.
Szczegóły znajdziesz także na stronie Rodzaje transakcji.
