01 / Flusso
Mantieni il riferimento aziendale in ogni evento
L'integrazione è più semplice da gestire quando i registri del pagamento, del giocatore o dell'ordine e del regolamento condividono i riferimenti fin dall'inizio.
- 01
Crea la sessione
Invia importo, valuta, riferimento aziendale e contesto di ritorno richiesti usando la struttura della richiesta indicata nella documentazione aggiornata.
- 02
Presenta l'esperienza di pagamento
Indirizza il cliente al checkout configurato o al percorso di pagamento restituito per quella sessione.
- 03
Elabora gli eventi documentati
Convalida e gestisci i tipi di evento e i campi descritti nella documentazione API aggiornata.
- 04
Accredita e riconcilia
Usa il riferimento di pagamento per collegare l'evento, il giocatore o l'ordine previsto, l'importo accreditato e il registro di regolamento.
02 / Operazioni
Scelte di integrazione che incidono sulle operazioni
Un'integrazione utile non si limita ad aprire il checkout. Conserva riferimenti, stati e percorsi di errore di cui l'operatore avrà bisogno dopo il lancio.
Progettazione dei riferimenti
Scegli riferimenti stabili per giocatore, ordine o fattura che possano essere trovati sia nel sistema dell'operatore sia nel registro Payfux.
Gestione degli eventi
Elabora esclusivamente campi e stati degli eventi documentati e conserva il riferimento ricevuto per audit e riconciliazione.
Comportamento al ritorno
Tratta il ritorno del cliente come navigazione dell'interfaccia, non come prova definitiva del completamento di un pagamento o di un regolamento.
Percorso di riconciliazione
Collega i registri di pagamento e regolamento nei sistemi dell'operatore, affinché le differenze possano essere esaminate tramite riferimento.
03 / Requisiti
Fa fede la documentazione aggiornata
Gli esempi commerciali descrivono la sequenza di integrazione, ma non definiscono endpoint di produzione, payload, firme, tentativi successivi, valori di stato o livelli di servizio.
- Usa esclusivamente l'autenticazione e i campi delle richieste indicati nella documentazione API aggiornata fornita per l'ambiente del cliente.
- Non considerare il ritorno del browser una prova autorevole del pagamento; usa lo stato lato server e il modello degli eventi documentati.
- Verifica la gestione di errori, duplicati, ritardi e cambiamenti di stato rispetto al comportamento documentato per l'integrazione.
04 / Domande
Domande degli operatori
Dove si trovano gli schemi API Payfux aggiornati?
Gli schemi aggiornati, i requisiti di autenticazione e i campi delle richieste si trovano nella documentazione API Payfux. Gli esempi di codice nelle pagine di prodotto hanno scopo esplicativo e non la sostituiscono.
Il ritorno del browser deve contrassegnare un pagamento come completato?
No. Il ritorno del cliente è navigazione. Per accredito e riconciliazione, l'operatore deve usare lo stato del pagamento lato server e le evidenze degli eventi documentati.
Payfux garantisce un determinato programma di nuovi tentativi degli eventi?
In questa pagina non viene dichiarato alcun programma di nuovi tentativi. Implementa il comportamento per eventi e ripristino indicato nella documentazione aggiornata del cliente.
Quale riferimento aziendale deve inviare un operatore?
Usa il riferimento stabile del giocatore, cliente, fattura o ordine richiesto dall'integrazione documentata e conservalo nel sistema dell'operatore.
I registri di test e quelli reali sono intercambiabili?
No. Mantieni separati credenziali, endpoint, registri e riconciliazione dei diversi ambienti e segui i controlli sugli ambienti indicati nella documentazione.
Documentazione per sviluppatori
Parti dagli schemi aggiornati di richieste ed eventi
Usa la documentazione Payfux per il comportamento esatto dell'integrazione, quindi allinea i riferimenti di pagamento ai sistemi dell'operatore.
Leggi la documentazione