Dati della sessione di gioco
Giocatore, brand, gioco, valuta, Paese, lingua, modalità, giurisdizione e durata dell'accesso.
Documentazione / Scenario di gioco
Scenario API di gioco
Percorso completo dalla verifica del giocatore e avvio del gioco fino a gestione di puntate, vincite, round di gioco, annullamenti e riconciliazione finanziaria.
Sessione
giocatore e avvio del gioco
Saldo
puntate e vincite
Round
flusso della sessione di gioco
Annullamento
ripristino delle operazioni
Ciclo di vita del gioco
Dall'avvio alla chiusura del round
01
Creare una sessione di gioco
Giocatore, gioco, valuta, lingua, Paese, modalità e URL di ritorno.
02
Avviare il gioco
Chiave di accesso temporanea, URL di avvio e verifica della disponibilità del gioco.
03
Gestire le operazioni finanziarie
Verifica del saldo, puntata, vincita, operazione combinata e risposte della piattaforma.
04
Chiudere e riconciliare il round
Risultato finale, annullamenti, registro finanziario e report del provider.
Panoramica
L'API di gioco collega giocatore, round e movimento dei fondi
L'avvio del gioco e il movimento dei fondi sono parti diverse dello stesso processo. La sessione identifica il giocatore e le condizioni di avvio, il round collega le azioni del provider e l'API della piattaforma conferma ogni addebito, accredito e annullamento.
Controllo del saldo
La piattaforma verifica i fondi disponibili e applica ogni puntata, pagamento o annullamento una sola volta.
Registro finanziario del gioco
Gli identificatori dell'operazione e del round, il tipo di operazione, l'importo e il saldo prima e dopo vengono conservati per controllo e riconciliazione.
Avvio del gioco
Scenario tipico di avvio del gioco
La piattaforma verifica prima il giocatore e la disponibilità del gioco, quindi crea una sessione a tempo limitato e riceve dal provider l'URL di avvio.
01
Verificare giocatore e disponibilità del gioco
La piattaforma verifica stato dell'account, valuta, Paese, restrizioni, limiti, modalità reale o demo e disponibilità del gioco.
02
Creare una sessione interna
Viene creato un identificatore di sessione con dati di giocatore, gioco, brand, valuta, lingua, IP e scadenza.
03
Ottenere l'URL di avvio del gioco
Il provider riceve chiave di sessione, endpoint di notifica e ritorno, tipo di dispositivo, giurisdizione e parametri dell'interfaccia.
04
Aprire il gioco nel browser
Il giocatore apre l'URL ricevuto, mentre le successive operazioni finanziarie avvengono direttamente tra i server.
Operazioni sul saldo
Principali operazioni sul saldo
I nomi dei metodi variano tra i provider, ma la logica resta comune: verifica del saldo, addebito della puntata, accredito della vincita e annullamento di un'operazione precedentemente confermata.
Verifica del saldo
Restituisce il saldo disponibile del giocatore nella valuta della sessione attiva senza modificare il registro finanziario.
Addebito della puntata
Verifica giocatore, sessione, valuta e fondi disponibili, quindi addebita una sola volta la puntata confermata.
Accredito della vincita
Accredita la vincita utilizzando identificatori univoci dell'operazione e del round, incluso il risultato pari a zero.
Puntata e risultato in una sola richiesta
Applica contemporaneamente la puntata e il risultato del gioco quando il provider supporta questo modello.
Annullamento dell'operazione
Crea un'operazione correttiva separata per una puntata o un pagamento precedentemente confermato senza eliminare la registrazione originale.
Bonus e giri gratuiti
Trasmette i dati della campagna bonus e del round di gioco, separando fondi reali e bonus.
Valuta e precisione dell'importo
Ogni operazione verifica valuta, unità dell'importo, numero di decimali e regole di arrotondamento.
Risposta della piattaforma
Restituisce stato dell'operazione, identificatore interno, saldo corrente e codice di errore unificato.
Ciclo di vita del round
Ciclo di vita del round di gioco
Un round può includere più puntate e risultati. Il suo stato dipende dalle regole del gioco, non soltanto dall'ordine delle richieste di rete.
Round creato
La piattaforma riceve per la prima volta l'identificatore del round e crea una registrazione interna.
Round attivo
Il round può contenere puntate aggiuntive, azioni di gioco e vincite intermedie.
Puntata accettata
L'addebito è confermato dalla piattaforma e collegato a un identificatore univoco dell'operazione del provider.
Risultato ricevuto
È stata ricevuta una vincita o un risultato pari a zero, ma il round può restare aperto in base alle regole del gioco.
Round chiuso
Il provider ha confermato la conclusione del round e tutte le operazioni finanziarie previste sono state elaborate.
Operazioni annullate
Una o più operazioni sono state corrette mantenendo l'intera cronologia originale.
Un round può includere più operazioni
L'identificatore del round non deve essere l'unica chiave di protezione dai duplicati. Ogni puntata, pagamento e annullamento deve avere un proprio identificatore univoco.
Affidabilità e riconciliazione
Protezione dai duplicati e riconciliazione finanziaria
L'API di gioco deve gestire in sicurezza richieste ripetute, ritardi di risposta, variazioni nell'ordine delle operazioni e il ripristino del provider dopo un errore.
Rielaborazione sicura
L'identificatore dell'operazione del provider è univoco per ogni tipo di azione finanziaria.
Una richiesta ripetuta restituisce il risultato originale e il saldo aggiornato senza un nuovo movimento di fondi.
Un nuovo tentativo con importo, valuta o giocatore diversi viene rifiutato come conflitto di dati.
L'annullamento fa riferimento a una specifica operazione originale e riceve anch'esso un proprio identificatore univoco.
Registro dei round e riconciliazione
Conservare gli identificatori di sessione, round, operazione del provider e operazione della piattaforma.
Registrare tipo di operazione, importo, valuta, saldo prima e dopo e tempo di elaborazione.
Non modificare le registrazioni contabilizzate, ma creare un'operazione correttiva separata.
Riconciliare i report del provider, i round di gioco, i movimenti del saldo, il GGR e le differenze rilevate.
Test
Cosa verificare nell'ambiente di test
Le verifiche devono coprire avvio del gioco, restrizioni del giocatore, saldo insufficiente, operazioni ripetute, ritardi di risposta, annullamenti e riconciliazione del round chiuso.
Avvio e sessione di gioco
Modalità reale e demo, valuta non valida, Paese vietato, accesso scaduto e gioco non disponibile.
Saldo e rifiuto della puntata
Fondi insufficienti, giocatore bloccato, valuta non corrispondente e superamento del limite.
Ritardo e risultato sconosciuto
Il provider non ha ricevuto risposta dopo l'effettivo addebito e reinvia l'operazione con lo stesso identificatore.
Puntate e vincite ripetute
Lo stesso identificatore arriva prima o dopo il completamento dell'elaborazione, anche con parametri in conflitto.
Annullamento delle operazioni
Annullamento della puntata, annullamento della vincita, annullamento ripetuto e riferimento a un'operazione originale sconosciuta.
Riconciliazione del round
Gli importi di puntate, vincite e annullamenti, lo stato finale, i movimenti del saldo e il report del provider devono coincidere.
Checklist prima del lancio
Il lancio avviene dopo aver verificato sessioni di gioco, operazioni sul saldo, protezione dai duplicati, annullamenti e reportistica.
Gli ambienti di test e produzione utilizzano accessi, endpoint API e impostazioni di avvio differenti.
La chiave della sessione di gioco ha una durata limitata ed è associata a giocatore, gioco, valuta e brand.
Ogni operazione sul saldo è protetta da un identificatore univoco del provider.
Puntate, vincite e annullamenti ripetuti non modificano il saldo una seconda volta.
Le registrazioni contabilizzate non vengono eliminate e vengono corrette tramite operazioni correttive separate.
Sono configurati log degli eventi, notifiche, report del provider e processo di riconciliazione dei round.
Devi configurare uno scenario API di gioco?
Fornisci la documentazione del provider, l'elenco delle operazioni sul saldo, il modello dei round di gioco, le valute e i requisiti di reportistica. APIACE ti aiuterà a strutturare avvio del gioco, puntate, vincite, annullamenti e riconciliazione finanziaria.