Wspólny numer operacji
Łączy gracza, kwotę, walutę, metodę płatności, dostawcę płatności i całą historię przetwarzania.
Dokumentacja / Scenariusz płatności
Jak działa API płatnicze
Poznaj pełną ścieżkę płatności: od utworzenia wpłaty i potwierdzenia płatności po zaksięgowanie środków, wypłatę, zwrot i uzgodnienia finansowe.
Wpłata
tworzenie i księgowanie
Wypłata
weryfikacja i wysłanie
Statusy
potwierdzenie operacji
Uzgodnienie
kontrola finansowa
Ścieżka płatności
Od zlecenia do wyniku końcowego
01
Utworzyć operację
Zapisać gracza, kwotę, walutę, metodę płatności i unikalny numer operacji.
02
Potwierdzić płatność
Przekierować gracza na stronę płatności, poprosić bank o potwierdzenie lub przeprowadzić płatność bezpośrednio.
03
Otrzymać status końcowy
Sprawdzić odpowiedź dostawcy płatności i potwierdzić ostateczny wynik operacji.
04
Zaktualizować saldo i ewidencję
Jednorazowo zaksięgować lub pobrać środki, uwzględnić prowizję i zapisać operację do uzgodnienia.
Przegląd
Każda płatność przechodzi kontrolowane etapy
Platforma nadaje operacji własny numer, wiąże ją z odpowiedzią dostawcy płatności i zmienia stan finansowy dopiero po potwierdzonym wyniku. Ponowne żądanie nie powinno tworzyć drugiego obciążenia ani uznania.
Jasne statusy
Operacja przechodzi tylko dozwolone etapy i nie zmienia zakończonego wyniku bez oddzielnej korekty.
Oddzielna ewidencja finansowa
Status płatności, zmiana salda, prowizja i zapis księgowy są ze sobą powiązane, ale weryfikowane oddzielnie.
Scenariusz wpłaty
Typowy scenariusz wpłaty
Wpłata zaczyna się od utworzenia operacji wewnętrznej i kończy jednokrotnym zaksięgowaniem po potwierdzeniu dostawcy płatności.
01
Sprawdzić żądanie i utworzyć operację
Platforma sprawdza gracza, KYC, limity, walutę, kwotę i metodę płatności, a następnie nadaje operacji numer wewnętrzny.
02
Przekazać płatność dostawcy
Dostawca otrzymuje kwotę, walutę, dane gracza, adres powrotu, adres powiadomień i wymagane dane płatnicze.
03
Potwierdzić płatność
Gracz potwierdza płatność na stronie zewnętrznej, przez 3-D Secure lub w aplikacji bankowej.
04
Otrzymać potwierdzenie i zaksięgować środki
Po weryfikacji podpisu i statusu końcowego platforma jednokrotnie zwiększa saldo gracza i kończy operację.
Wypłata i zwrot
Wypłata środków, anulowanie i zwrot
Operacje wychodzące wymagają weryfikacji gracza, dostępnego salda, ryzyka, danych odbiorcy i końcowej odpowiedzi dostawcy płatności.
Weryfikacja gracza
KYC, wiek, status konta, limity, samowykluczenie i dozwolone metody wypłaty.
Weryfikacja ryzyka
AML, oznaki oszustwa, warunki obrotu, źródło środków i zatwierdzenie operatora.
Rezerwacja kwoty
Kwota jest blokowana na saldzie do czasu otrzymania ostatecznego wyniku wypłaty.
Wysłanie do dostawcy płatności
Tworzony jest oddzielny wniosek o wypłatę z unikalnym numerem i potwierdzonymi danymi odbiorcy.
Oczekiwanie na wynik
Platforma przyjmuje statusy pośrednie i nie pobiera kwoty ponownie.
Zwrot
Zwrot jest tworzony jako oddzielna operacja powiązana z pierwotną płatnością i własną kwotą.
Anulowanie
Anulowanie jest możliwe tylko przed etapem nieodwracalnym i nie zastępuje zwrotu już zakończonej operacji.
Uzgodnienie końcowe
Raport dostawcy, dane wypłaty, prowizje i zmiany salda powinny wskazywać ten sam wynik.
Statusy operacji
Zalecany model statusów
Statusy wewnętrzne łączą różne odpowiedzi dostawców płatności w jeden spójny model zrozumiały dla platformy.
Utworzona
Operacja została utworzona w platformie, ale nie została jeszcze wysłana ani przyjęta przez dostawcę.
Wymagane działanie
Gracz musi potwierdzić płatność, podać dane lub wykonać działanie w banku.
Przetwarzana
Dostawca przyjął operację, ale wynik końcowy nie został jeszcze potwierdzony.
Zakończona
Operacja zakończyła się pomyślnie, po czym saldo jest zmieniane jednokrotnie.
Odrzucona
Operacja zakończyła się odmową z zapisaną przyczyną i bez ponownego obciążenia lub uznania.
Niepotwierdzona
Wynik operacji jest nieznany z powodu zerwania połączenia, opóźnienia odpowiedzi lub sprzecznych danych.
Nieznanego wyniku nie można traktować jako odmowy
Płatność mogła zostać przyjęta przez dostawcę nawet bez terminowej odpowiedzi. Najpierw pobierz aktualny status lub poczekaj na potwierdzenie, a dopiero potem decyduj o ponownej operacji.
Niezawodność i uzgodnienia
Ochrona przed ponowieniami i uzgodnienia finansowe
Niezawodność API płatniczego zależy od bezpiecznego zachowania przy ponownych żądaniach, opóźnionych potwierdzeniach i częściowych awariach.
Ochrona przed ponowną operacją
Każda wpłata, wypłata i zwrot otrzymują unikalny numer.
Ponowne żądanie zwraca istniejący wynik i nie tworzy nowej operacji finansowej.
Ponowne powiadomienie jest weryfikowane według numeru zdarzenia i bieżącego stanu płatności.
Zmiana salda jest powiązana z numerem płatności i stosowana tylko raz.
Ewidencja finansowa i uzgodnienia
Oddzielnie przechowywać kwotę, prowizję, kwotę końcową do zaksięgowania, walutę i numer dostawcy.
Nie nadpisywać zakończonego zapisu wstecznie, lecz tworzyć oddzielną korektę.
Uzgadniać operacje API, raporty dostawcy, zmiany salda i wypłaty.
Zapisywać rozbieżność, jej przyczynę, osobę odpowiedzialną i wynik korekty.
Testowanie
Co sprawdzić przed uruchomieniem
Sprawdź udaną płatność, odmowę, utratę połączenia, ponowne potwierdzenie, nieznany wynik, zwrot i uzgodnienie finansowe.
Udana wpłata i wypłata
Wszystkie statusy pośrednie, potwierdzenie, zmiana salda i raportowanie końcowe.
Odrzucenie operacji
Niewystarczające środki, nieprawidłowe dane, przekroczenie limitu, odmowa banku, kontrola ryzyka i niedostępna metoda płatności.
Utrata połączenia
Połączenie zostaje przerwane po wysłaniu żądania, a potwierdzenie przychodzi później lub jest pobierane oddzielnie.
Ponowne żądania
Ta sama operacja lub potwierdzenie przychodzą ponownie po zakończeniu przetwarzania.
Zwrot i anulowanie
Zwrot pełny i częściowy, anulowanie przed przetworzeniem oraz zakaz anulowania zakończonej operacji.
Uzgodnienie
Kwota, prowizja, status końcowy, saldo i raport dostawcy są zgodne po wszystkich scenariuszach.
Lista kontrolna przed uruchomieniem
Płatności produkcyjne są włączane po sprawdzeniu statusów, potwierdzeń, ochrony przed ponowieniami, salda i sprawozdawczości finansowej.
Dla środowiska testowego i produkcyjnego używane są różne dostępy, adresy powiadomień i konta.
Powrót użytkownika do serwisu nie jest traktowany jako dowód udanej płatności.
Podpis i numer zdarzenia są weryfikowane przed zmianą salda.
Wpłata, wypłata i zwrot są chronione przed ponownym wykonaniem.
Nieznany status jest wyjaśniany u dostawcy i sprawdzany podczas uzgodnienia.
Skonfigurowano powiadomienia o błędach, raporty PSP i procedurę analizy rozbieżności.
Chcesz zaprojektować scenariusz płatniczy?
Przekaż listę PSP, metod płatności, walut, rynków, zasad pracy z saldem i statusów. APIACE pomoże zbudować wpłatę, wypłatę, zwrot, potwierdzenie i uzgodnienia finansowe.