Numero univoco dell'operazione
Collega giocatore, importo, valuta, metodo di pagamento, provider di pagamento e intera cronologia di elaborazione.
Documentazione / Scenario di pagamento
Come funziona l'API di pagamento
Analizza l'intero percorso del pagamento: dalla creazione del deposito e conferma del pagamento fino all'accredito, al prelievo, al rimborso e alla riconciliazione finanziaria.
Deposito
creazione e accredito
Pagamento
verifica e invio
Stati
conferma delle operazioni
Riconciliazione
controllo finanziario
Percorso del pagamento
Dalla richiesta al risultato finale
01
Creare l'operazione
Registrare giocatore, importo, valuta, metodo di pagamento e numero univoco dell'operazione.
02
Confermare il pagamento
Reindirizzare il giocatore alla pagina di pagamento, richiedere la conferma della banca o elaborare il pagamento direttamente.
03
Ottenere lo stato finale
Verificare la risposta del provider di pagamento e confermare il risultato definitivo dell'operazione.
04
Aggiornare saldo e contabilità
Accreditare o addebitare i fondi una sola volta, registrare la commissione e salvare l'operazione per la riconciliazione.
Panoramica
Ogni pagamento attraversa fasi controllate
La piattaforma assegna all'operazione un proprio numero, la collega alla risposta del provider di pagamento e modifica lo stato finanziario solo dopo un risultato confermato. Una richiesta ripetuta non deve creare un secondo addebito o accredito.
Stati chiari
L'operazione attraversa solo fasi consentite e non modifica un risultato concluso senza una correzione separata.
Contabilità finanziaria separata
Stato del pagamento, variazione del saldo, commissione e registrazione contabile sono collegati tra loro, ma vengono verificati separatamente.
Scenario di deposito
Scenario tipico di deposito
Il deposito inizia con la creazione di un'operazione interna e termina con un unico accredito dopo la conferma del provider di pagamento.
01
Verificare la richiesta e creare l'operazione
La piattaforma verifica giocatore, KYC, limiti, valuta, importo e metodo di pagamento, quindi assegna all'operazione un numero interno.
02
Inviare il pagamento al provider
Il provider riceve importo, valuta, dati del giocatore, URL di ritorno, endpoint di notifica e dati necessari.
03
Confermare il pagamento
Il giocatore conferma il pagamento su una pagina esterna, tramite 3-D Secure o nell'app bancaria.
04
Ricevere la conferma e accreditare i fondi
Dopo aver verificato la firma e lo stato finale, la piattaforma aumenta una sola volta il saldo del giocatore e completa l'operazione.
Prelievo e rimborso
Prelievo, annullamento e rimborso
Le operazioni in uscita richiedono la verifica del giocatore, del saldo disponibile, dei rischi, dei dati di pagamento e della risposta finale del provider.
Verifica del giocatore
KYC, età, stato dell'account, limiti, autoesclusione e metodi di prelievo consentiti.
Valutazione del rischio
AML, segnali di frode, requisiti di wagering, fonte dei fondi e approvazione dell'operatore.
Riserva dell'importo
L'importo viene bloccato sul saldo fino al risultato definitivo del pagamento.
Invio al provider di pagamento
Viene creata una richiesta di pagamento separata con numero univoco e dati del destinatario verificati.
Attesa del risultato
La piattaforma accetta stati intermedi senza addebitare nuovamente l'importo.
Rimborso
Il rimborso viene creato come operazione separata, collegata al pagamento originale e con un proprio importo.
Annullamento
L'annullamento è possibile solo prima della fase irreversibile e non sostituisce il rimborso di un'operazione già completata.
Riconciliazione finale
Il report del provider, i dati del pagamento, le commissioni e le variazioni del saldo devono mostrare lo stesso risultato.
Stati dell'operazione
Modello di stati consigliato
Gli stati interni normalizzano le diverse risposte dei provider di pagamento in un modello unico e comprensibile per la piattaforma.
Creata
L'operazione è stata creata nella piattaforma ma non è ancora stata inviata o accettata dal provider.
Azione richiesta
Il giocatore deve confermare il pagamento, inserire i dati richiesti o eseguire un'azione presso la banca.
In elaborazione
Il provider ha accettato l'operazione, ma il risultato definitivo non è ancora confermato.
Completata
L'operazione è stata completata con successo e viene quindi applicata una sola variazione del saldo.
Rifiutata
L'operazione si conclude con un rifiuto, mantenendo il motivo e senza ulteriori addebiti o accrediti.
Non confermata
Il risultato dell'operazione è sconosciuto a causa di un'interruzione della connessione, un ritardo nella risposta o dati contraddittori.
Un risultato sconosciuto non può essere considerato un rifiuto
Il pagamento potrebbe essere stato accettato dal provider anche senza una risposta tempestiva. Prima richiedi lo stato aggiornato o attendi la conferma e solo dopo valuta un'eventuale nuova operazione.
Affidabilità e riconciliazione
Protezione dai duplicati e riconciliazione finanziaria
L'affidabilità dell'API di pagamento dipende da un comportamento sicuro in caso di richieste ripetute, conferme ritardate e guasti parziali.
Protezione dalla ripetizione dell'operazione
Ogni deposito, prelievo e rimborso riceve un numero univoco.
Una richiesta ripetuta restituisce il risultato esistente e non crea una nuova operazione finanziaria.
Una notifica ripetuta viene verificata tramite il numero dell'evento e lo stato corrente del pagamento.
La variazione del saldo viene collegata al numero del pagamento e applicata una sola volta.
Contabilità finanziaria e riconciliazione
Conservare separatamente importo, commissione, totale da accreditare, valuta e numero del provider.
Non riscrivere retroattivamente una registrazione conclusa, ma creare una correzione separata.
Riconciliare operazioni API, report del provider, variazioni del saldo e pagamenti.
Registrare la discrepanza, la causa, il responsabile e il risultato della correzione.
Test
Cosa verificare prima del lancio
Verificare pagamento riuscito, rifiuto, perdita di connessione, conferma ripetuta, risultato sconosciuto, rimborso e riconciliazione finanziaria.
Deposito e prelievo riusciti
Tutti gli stati intermedi, la conferma, la variazione del saldo e la reportistica finale.
Rifiuto dell'operazione
Fondi insufficienti, dati non validi, limite superato, rifiuto della banca, verifica del rischio e metodo di pagamento non disponibile.
Perdita di connessione
La connessione si interrompe dopo l'invio della richiesta e la conferma arriva più tardi o viene richiesta separatamente.
Richieste ripetute
La stessa operazione o conferma arriva nuovamente dopo il completamento dell'elaborazione.
Rimborso e annullamento
Rimborso totale e parziale, annullamento prima dell'elaborazione e divieto di annullare un'operazione già completata.
Riconciliazione
Importo, commissione, stato finale, saldo e report del provider coincidono dopo tutti gli scenari.
Checklist prima del lancio
I pagamenti in produzione vengono attivati dopo aver verificato stati, conferme, protezione dai duplicati, saldo e reportistica finanziaria.
Per gli ambienti di test e produzione vengono utilizzati accessi, endpoint di notifica e account differenti.
Il ritorno dell'utente al sito non viene utilizzato come prova di un pagamento riuscito.
Firma e numero dell'evento vengono verificati prima di modificare il saldo.
Deposito, prelievo e rimborso sono protetti dall'esecuzione ripetuta.
Uno stato sconosciuto viene chiarito con il provider e verificato durante la riconciliazione.
Sono configurate notifiche di errore, report PSP e procedure per l'analisi delle discrepanze.
Devi progettare uno scenario di pagamento?
Fornisci l'elenco di PSP, metodi di pagamento, valute, mercati, regole di gestione del saldo e stati. APIACE ti aiuterà a strutturare deposito, prelievo, rimborso, conferma e riconciliazione finanziaria.