Integrazione
Una superficie, costruita una volta, che resta ferma.
Tre pezzi: una chiamata REST che apre una verifica, un SDK che raccoglie ciò che il giocatore deve consegnare e un webhook firmato che porta l'esito. Tutto il resto è configurazione.
- 3parti mobili
- 1versione API in produzione
- 90 giornipreavviso minimo di dismissione
La forma della cosa
Che aspetto ha un'integrazione funzionante
01
Aprire una verifica
Il vostro backend invia i dati dichiarati e il mercato. Ricevete un identificativo di verifica e, dove servono documenti, token a vita breve per il client.
02
Passare i token al client
L'SDK prende in carico l'acquisizione: fotocamera, controllo di qualità, liveness, caricamento cifrato. Il vostro client non tratta mai le immagini e non detiene mai una credenziale a vita lunga.
03
Ricevere l'esito
La decisione arriva firmata, con i motivi e un identificativo del fascicolo di prova. Se il vostro endpoint è giù, si riprova, e dopo l'ultimo tentativo resta nel giornale in attesa che la recuperiate.
04
Continuare a ricevere
Gli eventi di monitoraggio usano lo stesso endpoint e la stessa firma: per la parte che dura anni non c'è una seconda integrazione.
Aprire una verifica
Richiesta e risposta
Richiesta
POST /v1/checks
Authorization: Bearer sk_live_…
Idempotency-Key: reg-91f4c7
{
"market": "GB",
"product": "casino",
"require": ["identity", "age", "exclusion", "sanctions"],
"person": {
"given_name": "Alex",
"family_name": "Harrington",
"date_of_birth": "1991-07-14",
"address": {
"line1": "12 Brock Street",
"postcode": "PR1 3XH",
"country": "GB"
}
},
"policy_version": "2026-09-01",
"reference": "signup-55218"
} Risposta
201 Created
{
"check_id": "chk_3Qv8ks2mPb",
"status": "collecting",
"market": "GB",
"required_steps": [
{ "step": "document", "sdk_token": "tok_9Hs…", "expires_in": 900 },
{ "step": "liveness", "sdk_token": "tok_9Hs…", "expires_in": 900 }
],
"policy_version": "2026-09-01",
"created_at": "2026-10-20T09:14:22Z"
} Idempotency-Key vale 24 ore: una registrazione ritentata restituisce la verifica originale anziché aprirne una seconda sullo stesso giocatore.