Dane sesji gry
Gracz, marka, gra, waluta, kraj, język, tryb, jurysdykcja i okres ważności dostępu.
Dokumentacja / Scenariusz gry
Scenariusz API gry
Pełna ścieżka od weryfikacji gracza i uruchomienia gry do obsługi zakładów, wygranych, rund gry, anulowania operacji i uzgodnień finansowych.
Sesja
gracz i uruchomienie gry
Saldo
zakłady i wygrane
Rundy
przebieg sesji gry
Anulowanie
odzyskiwanie operacji
Cykl życia gry
Od uruchomienia do zamknięcia rundy
01
Utworzyć sesję gry
Gracz, gra, waluta, język, kraj, tryb i adres powrotny.
02
Uruchomić grę
Tymczasowy klucz dostępu, adres uruchomienia i sprawdzenie dostępności gry.
03
Obsłużyć operacje finansowe
Sprawdzenie salda, zakład, wygrana, operacja łączona i odpowiedzi platformy.
04
Zamknąć i uzgodnić rundę
Wynik końcowy, anulowania, dziennik finansowy i raport dostawcy.
Przegląd
API gry łączy gracza, rundę i przepływ środków
Uruchomienie gry i przepływ środków są różnymi częściami jednego procesu. Sesja określa gracza i warunki uruchomienia, runda łączy działania dostawcy, a API platformy potwierdza każde obciążenie, uznanie i anulowanie.
Kontrola salda
Platforma sprawdza dostępne środki i stosuje każdy zakład, wypłatę lub anulowanie tylko jeden raz.
Dziennik finansowy gry
Identyfikatory operacji i rundy, typ operacji, kwota oraz saldo przed i po są zapisywane do kontroli i uzgodnień.
Uruchomienie gry
Typowy scenariusz uruchomienia gry
Najpierw platforma sprawdza gracza i dostępność gry, następnie tworzy sesję ograniczoną czasowo i otrzymuje od dostawcy adres uruchomienia.
01
Sprawdzić gracza i dostępność gry
Platforma sprawdza status konta, walutę, kraj, ograniczenia, limity, tryb rzeczywisty lub demo i dostępność gry.
02
Utworzyć sesję wewnętrzną
Tworzony jest identyfikator sesji z danymi gracza, gry, marki, waluty, języka, IP i czasu ważności.
03
Otrzymać adres uruchomienia gry
Dostawca otrzymuje klucz sesji, adresy powiadomień i powrotu, typ urządzenia, jurysdykcję i parametry interfejsu.
04
Otworzyć grę w przeglądarce
Gracz otwiera otrzymany adres, a dalsze operacje finansowe są wykonywane bezpośrednio między serwerami.
Operacje na saldzie
Podstawowe operacje na saldzie
Nazwy metod różnią się u dostawców, ale logika pozostaje wspólna: sprawdzenie salda, obciążenie zakładem, uznanie wygranej i anulowanie wcześniej potwierdzonej operacji.
Sprawdzenie salda
Zwraca dostępne saldo gracza w walucie aktywnej sesji bez zmiany dziennika finansowego.
Obciążenie zakładem
Sprawdza gracza, sesję, walutę i dostępne środki, a następnie jednokrotnie pobiera potwierdzony zakład.
Uznanie wygranej
Dopisuje wygraną na podstawie unikalnych identyfikatorów operacji i rundy, także dla wyniku zerowego.
Zakład i wynik w jednym żądaniu
Jednocześnie stosuje zakład i wynik gry, gdy taki model jest obsługiwany przez dostawcę.
Anulowanie operacji
Tworzy oddzielną operację korygującą dla wcześniej potwierdzonego zakładu lub wypłaty bez usuwania pierwotnego zapisu.
Bonusy i darmowe spiny
Przekazuje dane kampanii bonusowej i rundy gry, rozdzielając środki rzeczywiste i bonusowe.
Waluta i precyzja kwoty
Każda operacja sprawdza walutę, jednostki kwoty, liczbę miejsc po przecinku i zasady zaokrąglania.
Odpowiedź platformy
Zwraca status operacji, jej wewnętrzny identyfikator, bieżące saldo i wspólny kod błędu.
Cykl życia rundy
Cykl życia rundy gry
Jedna runda może obejmować kilka zakładów i wyników. Jej stan jest określany przez zasady gry, a nie tylko kolejność żądań sieciowych.
Runda utworzona
Platforma po raz pierwszy otrzymuje identyfikator rundy i tworzy zapis wewnętrzny.
Runda aktywna
Runda może zawierać dodatkowe zakłady, działania w grze i wygrane pośrednie.
Zakład przyjęty
Obciążenie zostało potwierdzone przez platformę i powiązane z unikalnym identyfikatorem operacji dostawcy.
Otrzymano wynik
Otrzymano wygraną lub wynik zerowy, ale runda może pozostawać otwarta zgodnie z zasadami gry.
Runda zamknięta
Dostawca potwierdził zakończenie rundy, a wszystkie oczekiwane operacje finansowe zostały przetworzone.
Operacje anulowane
Jedna lub kilka operacji zostało skorygowanych z zachowaniem pełnej historii pierwotnej.
Jedna runda może obejmować wiele operacji
Identyfikator rundy nie powinien być jedynym kluczem ochrony przed ponowieniami. Każdy zakład, wypłata i anulowanie powinny mieć własny unikalny identyfikator.
Niezawodność i uzgodnienia
Ochrona przed ponowieniami i uzgodnienia finansowe
API gry powinno bezpiecznie obsługiwać ponowne żądania, opóźnienia odpowiedzi, zmianę kolejności operacji i odzyskanie dostawcy po awarii.
Bezpieczne ponowne przetwarzanie
Identyfikator operacji dostawcy jest unikalny dla każdego typu działania finansowego.
Ponowne żądanie zwraca pierwotny wynik i aktualne saldo bez ponownego przepływu środków.
Ponowienie z inną kwotą, walutą lub graczem jest odrzucane jako konflikt danych.
Anulowanie odwołuje się do konkretnej operacji pierwotnej i również otrzymuje własny unikalny identyfikator.
Dziennik rund i uzgodnienia
Przechowywać identyfikatory sesji, rundy, operacji dostawcy i operacji platformy.
Zapisywać typ operacji, kwotę, walutę, saldo przed i po oraz czas przetwarzania.
Nie zmieniać zaksięgowanych zapisów, lecz tworzyć oddzielną operację korygującą.
Uzgadniać raporty dostawcy, rundy gry, ruch salda, GGR i wykryte różnice.
Testowanie
Co sprawdzić w środowisku testowym
Testy powinny obejmować uruchomienie gry, ograniczenia gracza, niewystarczające saldo, ponowne operacje, opóźnienia odpowiedzi, anulowania i uzgodnienie zamkniętej rundy.
Uruchomienie i sesja gry
Tryb rzeczywisty i demo, nieprawidłowa waluta, niedozwolony kraj, wygasły dostęp i niedostępna gra.
Saldo i odrzucenie zakładu
Niewystarczające środki, zablokowany gracz, niezgodność waluty i przekroczenie limitu.
Opóźnienie i nieznany wynik
Dostawca nie otrzymał odpowiedzi po faktycznym obciążeniu i ponownie wysyła operację z tym samym identyfikatorem.
Powtórzone zakłady i wygrane
Ten sam identyfikator przychodzi przed lub po zakończeniu przetwarzania, również z konfliktującymi parametrami.
Anulowanie operacji
Anulowanie zakładu, anulowanie wygranej, ponowne anulowanie i odwołanie do nieznanej operacji pierwotnej.
Uzgodnienie rundy
Kwoty zakładów, wygranych i anulowań, status końcowy, ruch salda i raport dostawcy powinny być zgodne.
Lista kontrolna przed uruchomieniem
Uruchomienie następuje po sprawdzeniu sesji gry, operacji na saldzie, ochrony przed ponowieniami, anulowań i raportowania.
Środowiska testowe i produkcyjne używają różnych dostępów, adresów API i ustawień uruchomienia.
Klucz sesji gry jest ograniczony czasowo i powiązany z graczem, grą, walutą i marką.
Każda operacja na saldzie jest chroniona unikalnym identyfikatorem dostawcy.
Powtórzone zakłady, wygrane i anulowania nie zmieniają salda po raz drugi.
Zaksięgowane wpisy nie są usuwane i są korygowane przez oddzielne operacje korygujące.
Skonfigurowano dzienniki zdarzeń, powiadomienia, raporty dostawcy i proces uzgadniania rund.
Chcesz skonfigurować scenariusz API gry?
Przekaż dokumentację dostawcy, listę operacji na saldzie, model rund gry, waluty i wymagania raportowe. APIACE pomoże zbudować uruchomienie gry, zakłady, wygrane, anulowania i uzgodnienia finansowe.