Datele sesiunii de joc
Jucător, brand, joc, valută, țară, limbă, mod, jurisdicție și termenul de valabilitate al accesului.
Documentație / Scenariu de joc
Scenariul API pentru jocuri
Traseul complet de la verificarea jucătorului și lansarea jocului până la procesarea pariurilor, câștigurilor, rundelor de joc, anulărilor și reconcilierii financiare.
Sesiune
jucător și lansarea jocului
Sold
pariuri și câștiguri
Runde
fluxul sesiunii de joc
Anulare
recuperarea operațiunilor
Ciclul de viață al jocului
De la lansare la închiderea rundei
01
Creați o sesiune de joc
Jucător, joc, valută, limbă, țară, mod și URL de returnare.
02
Lansați jocul
Cheie temporară de acces, URL de lansare și verificarea disponibilității jocului.
03
Procesați operațiunile financiare
Verificarea soldului, pariu, câștig, operațiune combinată și răspunsurile platformei.
04
Închideți și reconciliați runda
Rezultat final, anulări, registru financiar și raportul furnizorului.
Prezentare generală
API-ul de joc leagă jucătorul, runda și mișcarea fondurilor
Lansarea jocului și mișcarea fondurilor sunt părți diferite ale aceluiași proces. Sesiunea identifică jucătorul și condițiile de lansare, runda leagă acțiunile furnizorului, iar API-ul platformei confirmă fiecare debitare, creditare și anulare.
Controlul soldului
Platforma verifică fondurile disponibile și aplică fiecare pariu, plată sau anulare o singură dată.
Registrul financiar al jocului
Identificatorii operațiunii și rundei, tipul operațiunii, suma și soldurile înainte și după sunt păstrate pentru control și reconciliere.
Lansarea jocului
Scenariu tipic de lansare a jocului
Platforma verifică mai întâi jucătorul și disponibilitatea jocului, apoi creează o sesiune limitată în timp și primește URL-ul de lansare de la furnizor.
01
Verificați jucătorul și disponibilitatea jocului
Platforma verifică starea contului, valuta, țara, restricțiile, limitele, modul pe bani reali sau demo și disponibilitatea jocului.
02
Creați o sesiune internă
Se creează un identificator de sesiune cu datele jucătorului, jocului, brandului, valutei, limbii, IP-ului și termenului de expirare.
03
Obțineți URL-ul de lansare al jocului
Furnizorul primește cheia sesiunii, URL-urile de notificare și returnare, tipul dispozitivului, jurisdicția și parametrii interfeței.
04
Deschideți jocul în browser
Jucătorul deschide URL-ul primit, iar operațiunile financiare ulterioare sunt procesate direct între servere.
Operațiuni de sold
Operațiuni principale de sold
Denumirile metodelor diferă între furnizori, dar logica rămâne aceeași: verificarea soldului, debitarea pariului, creditarea câștigului și anularea unei operațiuni confirmate anterior.
Verificarea soldului
Returnează soldul disponibil al jucătorului în valuta sesiunii active, fără a modifica registrul financiar.
Debitarea pariului
Verifică jucătorul, sesiunea, valuta și fondurile disponibile, apoi debitează o singură dată pariul confirmat.
Creditarea câștigului
Creditează câștigul folosind identificatori unici ai operațiunii și rundei, inclusiv un rezultat zero.
Pariu și rezultat într-o singură solicitare
Aplică simultan pariul și rezultatul jocului atunci când furnizorul acceptă acest model.
Anularea operațiunii
Creează o operațiune corectivă separată pentru un pariu sau o plată confirmată anterior, fără a șterge înregistrarea inițială.
Bonusuri și rotiri gratuite
Transmite datele campaniei de bonus și ale rundei de joc, separând fondurile reale de cele bonus.
Valută și precizia sumei
Fiecare operațiune verifică valuta, unitățile sumei, numărul de zecimale și regulile de rotunjire.
Răspunsul platformei
Returnează starea operațiunii, identificatorul intern, soldul curent și un cod de eroare unificat.
Ciclul de viață al rundei
Ciclul de viață al rundei de joc
O rundă poate include mai multe pariuri și rezultate. Starea ei este determinată de regulile jocului, nu doar de ordinea solicitărilor de rețea.
Runda a fost creată
Platforma primește pentru prima dată identificatorul rundei și creează o înregistrare internă.
Runda este activă
Runda poate conține pariuri suplimentare, acțiuni de joc și câștiguri intermediare.
Pariul a fost acceptat
Debitarea este confirmată de platformă și legată de identificatorul unic al operațiunii furnizorului.
Rezultatul a fost primit
A fost primit un câștig sau un rezultat zero, dar runda poate rămâne deschisă conform regulilor jocului.
Runda a fost închisă
Furnizorul a confirmat încheierea rundei, iar toate operațiunile financiare așteptate au fost procesate.
Operațiunile au fost anulate
Una sau mai multe operațiuni au fost corectate, păstrând istoricul inițial complet.
O rundă poate include mai multe operațiuni
Identificatorul rundei nu trebuie să fie singura cheie de idempotentă. Fiecare pariu, plată și anulare trebuie să aibă propriul identificator unic.
Fiabilitate și reconciliere
Protecție împotriva repetărilor și reconciliere financiară
API-ul de joc trebuie să gestioneze în siguranță solicitările repetate, întârzierile răspunsului, operațiunile primite în ordine diferită și recuperarea furnizorului după o defecțiune.
Procesare repetată în siguranță
Identificatorul operațiunii furnizorului este unic pentru fiecare tip de acțiune financiară.
O solicitare repetată returnează rezultatul inițial și soldul actual, fără a muta din nou fondurile.
O repetare cu altă sumă, valută sau alt jucător este respinsă ca un conflict de date.
Anularea face referire la o anumită operațiune inițială și primește, de asemenea, propriul identificator unic.
Registrul rundelor și reconciliere
Păstrați identificatorii sesiunii, rundei, operațiunii furnizorului și operațiunii platformei.
Înregistrați tipul operațiunii, suma, valuta, soldurile înainte și după și timpul de procesare.
Nu modificați înregistrările contabilizate; creați o operațiune corectivă separată.
Reconciliați rapoartele furnizorului, rundele de joc, mișcările soldului, GGR și diferențele identificate.
Testare
Ce trebuie verificat în mediul de testare
Verificările trebuie să acopere lansarea jocului, restricțiile jucătorului, soldul insuficient, operațiunile repetate, întârzierile răspunsului, anulările și reconcilierea unei runde închise.
Lansare și sesiune de joc
Moduri pe bani reali și demo, valută invalidă, țară interzisă, acces expirat și joc indisponibil.
Sold și refuzul pariului
Fonduri insuficiente, jucător blocat, neconcordanță de valută și limită depășită.
Întârziere și rezultat necunoscut
Furnizorul nu primește răspuns după ce debitarea a avut loc efectiv și retrimite operațiunea cu același identificator.
Pariuri și câștiguri repetate
Același identificator sosește înainte sau după finalizarea procesării, inclusiv cu parametri contradictorii.
Anularea operațiunilor
Anularea pariului, anularea câștigului, anulare repetată și referire la o operațiune inițială necunoscută.
Reconcilierea rundei
Sumele pariurilor, câștigurilor și anulărilor, starea finală, mișcarea soldului și raportul furnizorului trebuie să corespundă.
Listă de verificare înainte de lansare
Lansarea are loc după verificarea sesiunilor de joc, operațiunilor de sold, protecției împotriva repetărilor, anulărilor și raportării.
Mediile de testare și producție utilizează accesuri, endpoint-uri API și setări de lansare diferite.
Cheia sesiunii de joc este limitată în timp și legată de jucător, joc, valută și brand.
Fiecare operațiune de sold este protejată de un identificator unic al furnizorului.
Pariurile, câștigurile și anulările repetate nu modifică soldul a doua oară.
Înregistrările contabilizate nu sunt șterse și sunt corectate prin operațiuni de ajustare separate.
Sunt configurate jurnalele de evenimente, notificările, rapoartele furnizorului și procesul de reconciliere a rundelor.
Trebuie configurat scenariul API pentru jocuri?
Trimiteți documentația furnizorului, lista operațiunilor de sold, modelul rundelor de joc, valutele și cerințele de raportare. APIACE vă va ajuta să structurați lansarea jocului, pariurile, câștigurile, anulările și reconcilierea financiară.