Sandbox
Sandbox-API-nycklar för identitetsverifiering.
En sandbox-nyckel kör exakt samma API, hostade sida och webhook-flöde som produktion, på en nyckel som aldrig faktureras. Det är det snabbaste sättet att se om ShieldID passar innan priser diskuteras.
Så fungerar det
Samma pipeline. Annan nyckel. Ingen faktura.
Sandbox är inget förenklat demoläge – det är den riktiga verifieringspipelinen, styrd enbart av vilken nyckel som skickas.
| Nyckelprefix | vk_sand_… identifierar en sandbox-nyckel vid autentiseringen. Det finns inget separat sandbox-konto eller någon separat dashboard att konfigurera. |
|---|---|
| Miljöstämpel | Varje session, resultat och webhook som skapas med en sandbox-nyckel har environment: "sandbox", så att inget som skapats i sandbox kan förväxlas med en riktig verifiering längre fram i flödet. |
| Fakturering | Sandbox-sessioner faktureras aldrig, oavsett plan, hur många sessioner som helst medan du bygger och testar din integration. |
| Själva verifieringen | På riktigt: ditt eget dokument, ditt eget ansikte, samma kontroller. Det finns ingen separat uppsättning falska testdokument – du verifierar dig själv för att se hur produkten beter sig. |
Skaffa en nyckel
Begär en i dag. Självbetjäning kommer.
Skapande av sandbox-nycklar via självbetjäning på kvalificerande planer är planerat men ännu inte tidssatt. Tills det lanseras får du en nyckel direkt genom en förfrågan via kontaktformuläret.
Idag
Berätta lite om vad du bygger i kontaktformuläret så ordnar vi en sandbox-nyckel – de flesta förfrågningar samma arbetsdag.
Snart
Kommer snartSkapande av sandbox-nycklar via självbetjäning, på kvalificerande planer, är planerat men ännu inte tidssatt, så att du kan skapa en nyckel direkt när du registrerar dig.
Testa själv
Testscenarier som du kan köra på din egen mobil.
Inga falska dokument behövs – kör dessa mot ditt eget ID för att se hur varje väg faktiskt beter sig.
Ett rent godkännande
Skapa en session, öppna den hostade sidan, fotografera ditt eget ID och slutför liveness-kontrollen. Se hur checks.document, checks.liveness, checks.antispoof och checks.face_match alla kommer tillbaka som PASS.
En nekad kamera
Neka kamerabehörigheten när den hostade sidan frågar. Sessionen landar i FAILED med en failure_reason som du kan bygga ett riktigt felmeddelande kring.
Nytt försök efter misslyckande (kommer snart)
Att öppna en FAILED-sessions verification_url igen för att återställa den till PENDING för ett andra försök är inte live ännu. Än så länge gäller FAILED som slutgiltigt – skapa en ny session om den sökande vill försöka igen.
En utgången session
Skapa en session och rör den inte. Efter standardtiden går den över till EXPIRED, utan person- eller kontrolldata – ett bra tillstånd för att testa gränssnittets timeout-meddelanden.
En avbruten session
Anropa DELETE /v1/sessions/{id} på en PENDING-session och försök sedan öppna verification_url. Bekräfta att appen behandlar en avbruten session som avslutad, inte som ett fel.
Fransk locale
Skapa en session med locale: "fr" och bekräfta att den hostade sidan och din egen hantering av return-URL fungerar som de ska för en franskspråkig sökande.
Begränsningar
Vad sandbox inte gör.
Raka svar, inget finstilt.
- Sandbox har ingen separat rate limit jämfört med produktion – ingen request begränsas för närvarande av gränser på plannivå alls; den tillämpningen är inte live ännu.
- Sandbox och produktion skiljs åt enbart via nyckelprefix, inte via separata konton, dashboards eller dokumentuppsättningar.
- En sandbox-session är en riktig verifiering av ett riktigt dokument. Använd inte någon annans ID för att testa – verifiera ditt eget.
Frågor
Vanliga frågor om sandbox.
Skaffa en nyckel
Begär en sandbox-nyckel.
Berätta vad du bygger så ger vi dig en nyckel att börja testa med.
Sandbox-sessioner debiteras aldrig.