01 / Przebieg

Zachowaj identyfikator biznesowy w każdym zdarzeniu

Integracja jest najłatwiejsza w obsłudze, gdy rejestry płatności, gracza lub zamówienia oraz rozliczenia mają wspólne identyfikatory od samego początku.

01
Utwórz sesję
Wyślij wymaganą kwotę, walutę, identyfikator biznesowy i kontekst powrotu w aktualnie udokumentowanej strukturze żądania.
02
Pokaż doświadczenie płatnicze
Skieruj klienta do skonfigurowanego checkoutu lub ścieżki płatności zwróconej dla tej sesji.
03
Obsłuż udokumentowane zdarzenia
Waliduj i obsługuj typy zdarzeń oraz pola opisane w aktualnej dokumentacji API.
04
Uznaj i uzgodnij
Użyj identyfikatora płatności, aby połączyć zdarzenie, właściwego gracza lub zamówienie, uznaną kwotę i rejestr rozliczenia.

02 / Operacje

Decyzje integracyjne wpływające na operacje

Użyteczna integracja nie tylko otwiera checkout. Zachowuje identyfikatory, statusy i ścieżki błędów potrzebne operatorowi po uruchomieniu.

Projekt identyfikatorów

Wybierz stałe identyfikatory gracza, zamówienia lub faktury, które można znaleźć zarówno w systemie operatora, jak i rejestrze Payfux.

Obsługa zdarzeń

Przetwarzaj wyłącznie udokumentowane pola i statusy zdarzeń oraz zachowuj otrzymany identyfikator do audytu i uzgadniania.

Zachowanie przy powrocie

Traktuj powrót klienta jako nawigację interfejsu, a nie ostateczny dowód zakończenia płatności lub rozliczenia.

Ścieżka uzgadniania

Połącz rejestry płatności i rozliczeń we własnych systemach operatora, aby można było badać różnice według identyfikatora.

03 / Wymagania

Obowiązuje aktualna dokumentacja

Przykłady marketingowe opisują sekwencję integracji, ale nie definiują endpointów produkcyjnych, payloadów, podpisów, ponowień, wartości statusów ani poziomów usług.

Używaj wyłącznie uwierzytelnienia i pól żądań z bieżącej dokumentacji API dostarczonej dla środowiska klienta.
Nie traktuj powrotu w przeglądarce jako rozstrzygającego dowodu płatności; korzystaj z udokumentowanego modelu statusów i zdarzeń po stronie serwera.
Testuj obsługę błędów, duplikatów, opóźnień i zmian statusu zgodnie z zachowaniem opisanym dla integracji.

04 / Pytania

Pytania operatorów

Gdzie znajdują się aktualne schematy API Payfux?

Aktualne schematy, wymagania uwierzytelnienia i pola żądań znajdują się w dokumentacji API Payfux. Przykłady kodu na stronach produktu mają charakter objaśniający i jej nie zastępują.

Czy powrót w przeglądarce powinien oznaczać płatność jako zakończoną?

Nie. Powrót klienta służy nawigacji. Operator powinien korzystać z udokumentowanego statusu płatności i dowodów zdarzeń po stronie serwera do uznawania i uzgadniania.

Czy Payfux obiecuje określony harmonogram ponawiania zdarzeń?

Na tej stronie nie deklarujemy harmonogramu ponowień. Zaimplementuj obsługę zdarzeń i odzyskiwania opisaną w aktualnej dokumentacji klienta.

Jaki identyfikator biznesowy powinien wysłać operator?

Użyj stałego identyfikatora gracza, klienta, faktury lub zamówienia wymaganego przez udokumentowaną integrację i zachowaj go w systemie operatora.

Czy rejestry testowe i produkcyjne są zamienne?

Nie. Oddzielaj dane uwierzytelniające środowisk, endpointy, rejestry i uzgadnianie oraz przestrzegaj mechanizmów środowiskowych opisanych w dokumentacji.

Dokumentacja dla deweloperów

Zacznij od aktualnych schematów żądań i zdarzeń

Korzystaj z dokumentacji Payfux, aby poznać dokładne zachowanie integracji, a następnie dopasuj identyfikatory płatności do systemów operatora.

Przeczytaj dokumentację