Richiedi la prova
La tua richiesta richiede la prova necessaria per un'azione, ad esempio maggiore di 18 anni o verificata da un essere umano.
VERIFICA PER SVILUPPATORI
Collega il tuo sito, copia il tuo ID Checkify Pass, scegli cosa desideri verificare e rilascia Checkify in accesso, checkout, commenti, moduli di contatto o nel tuo flusso personalizzato.
MODELLO DI INTEGRAZIONE
La tua domanda richiede una prova. Checkify gestisce il percorso del cliente. Ricevi un risultato e decidi cosa succede dopo.
La tua richiesta richiede la prova necessaria per un'azione, ad esempio maggiore di 18 anni o verificata da un essere umano.
Checkify determina se esistono prove sufficienti o se il cliente deve completare una verifica aggiuntiva.
Il tuo server conferma il risultato e consente, blocca o continua l'azione protetta.
API REALE
Dopo che il cliente ha completato una sessione Pass, il tuo backend verifica request_id con una chiave API del sito. Non inserire mai la chiave API del sito nel codice del browser.
Richiesta
POST /v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY
Content-Type: application/json
{
"request_id": "56a57761-ff5b-42f0-9c97-6c13e223e017",
"required_claims": ["age_over_18"],
"consume": true
}
Risposta
{
"success": true,
"status": "completed",
"approved_claims": {
"age_over_18": true
}
}
Il browser o il plugin memorizza un request_id (spesso come checkify_token). Il tuo server è l'autorità: conferma approve_claims prima di consentire l'azione.
COSA PUOI RICHIEDERE
Modifica il tipo di richiesta o le richieste richieste per ogni viaggio, senza ricostruire l'infrastruttura di verifica.
Richiedi una soglia di età come oltre 13, 16, 18 o 25.
age_over_18Stabilire che una persona reale sia presente per moduli, accessi e controlli sugli abusi.
human_verifiedRichiedi il livello di garanzia adeguato al rischio: da Basic a HighAssurance.
basic → highAssuranceI livelli di garanzia e le opzioni esatte delle prove dipendono dal percorso, dal dispositivo e dalla policy configurata. Consulta la guida alla verifica del server per i nomi delle attestazioni.
COME INTEGRARE
Inizia con il percorso che corrisponde al tuo stack. Tutti i percorsi di produzione utilizzano lo stesso modello di prova.
WordPress, WooCommerce e Joomla / J2Commerce per CMS comuni e porte di pagamento.
Guida WordPress →Incorporamento e bindForm CDN per siti Web personalizzati. Avvia le sessioni Pass e scrive il token nel modulo.
Incorpora documenti →Conferma i risultati con POST /v1/qr/results/verify e una chiave API del sito (csk_).
Verifica del server →Luoghi e viaggi da dispositivo a dispositivo utilizzando Pass e trasferimento QR.
Guida fisica del personale →Shopify e Wix sono in lista d'attesa/disponibili a breve e non sono elencati come integrazioni di produzione live qui.
Credenziali
Checkify utilizza due credenziali diverse. L'errore di integrazione più comune è quello di utilizzare la credenziale sbagliata nel posto sbagliato.
Browser embed, WordPress, Joomla — frontend only
Backend verify API — server only, never in JavaScript
CONSEGNA DEL RISULTATO
Per i flussi di pagamento e siti Web standard, verifica request_id sul tuo server quando viene inviata l'azione protetta. Il polling dello stato opzionale è disponibile per frontend personalizzati.
La tua pagina o il tuo plug-in avvia una richiesta Checkify Pass associata al tuo sito.
Il cliente verifica o approva nell'app Checkify.
Chiama l'endpoint di verifica, controlla approvato_claims, quindi consenti o blocca.
Oggi i webhook di verifica generici non sono necessari per le integrazioni standard. I webhook in uscita dei partner (ad esempio GoHighLevel) sono configurati separatamente nel dashboard aziendale.
DOCUMENTAZIONE
Utilizza queste guide per approfondire l'implementazione. Questa pagina rimane focalizzata sul modello di integrazione.
Incorpora un Pass e associa un modulo per la tua prima azione protetta.
Apri avvio rapido →Endpoint utilizzati dalle integrazioni pubbliche, inclusi verifica e stato.
Apri i documenti API →attributi data-checkify, opzioni bindForm e tipi di richiesta.
Apri documenti incorporati →Chiavi API del sito, require_claims, consume e Signed_result.
Apri la guida del server →Aggiungi Checkify prima a un percorso (età, persona o identità), quindi espandilo man mano che le esigenze del tuo prodotto crescono.