Bac à sable
Clés Sandbox API pour la vérification d'identité.
Une clé de bac à sable exécute exactement le même flux d'API, de page hébergée et de webhook qu'en production, avec une clé qui n'est jamais facturée. C'est le moyen le plus rapide de voir si ShieldID vous convient avant de parler tarifs.
Comment ça fonctionne
Même chaîne de traitement. Clé différente. Aucune facture.
Le bac à sable n'est pas un mode démo simplifié — c'est la véritable chaîne de vérification, déterminée uniquement par la clé que vous envoyez.
| Préfixe de clé | vk_sand_… identifie une clé de bac à sable au moment de l'authentification. Il n'y a ni compte de bac à sable distinct ni tableau de bord à configurer. |
|---|---|
| Marqueur d'environnement | Chaque session, résultat et webhook créé avec une clé de bac à sable porte environment: "sandbox", de sorte que rien de ce qui est créé en bac à sable ne puisse être pris pour une vraie vérification en aval. |
| Facturation | Les sessions en bac à sable ne sont jamais facturées, quel que soit le forfait, pour autant de sessions que nécessaire pour développer et tester votre intégration. |
| La vérification elle-même | Réel : votre propre document, votre propre visage, les mêmes contrôles. Il n'y a pas de jeu distinct de faux documents de test — vous vous vérifiez vous-même pour voir comment le produit se comporte. |
Obtenir une clé
Demandez-en une dès aujourd'hui. Le libre-service s'en vient.
La création de clés de bac à sable en libre-service sur les forfaits admissibles est prévue, mais pas encore planifiée. D'ici là, une demande par le formulaire de contact vous permet d'obtenir une clé directement.
Aujourd'hui
Dites-nous brièvement ce que vous développez dans le formulaire de contact et nous vous remettrons une clé de bac à sable — la plupart des demandes le jour ouvrable même.
Bientôt
Bientôt disponibleLa création de clés de bac à sable en libre-service, sur les forfaits admissibles, est prévue mais pas encore planifiée, pour que vous puissiez générer une clé dès votre inscription.
Essayez-le vous-même
Scénarios de test à exécuter sur votre propre téléphone.
Aucun faux document nécessaire — exécutez-les avec votre propre pièce d'identité pour voir comment chaque parcours se comporte réellement.
Une réussite sans faille
Créez une session, ouvrez la page hébergée, photographiez votre propre pièce d'identité et relevez le défi de preuve de vie. Observez checks.document, checks.liveness, checks.antispoof et checks.face_match retourner chacun PASS.
Une caméra refusée
Refusez l'autorisation d'accès à la caméra lorsque la page hébergée la demande. La session passe à FAILED avec un failure_reason à partir duquel vous pouvez bâtir un vrai message d'erreur.
Une nouvelle tentative après un échec (bientôt)
La réouverture de la verification_url d'une session FAILED pour la remettre à PENDING en vue d'une deuxième tentative n'est pas encore disponible. Pour l'instant, considérez FAILED comme un état final — créez une nouvelle session si le demandeur souhaite réessayer.
Une session expirée
Créez une session et n'y touchez pas. Après le délai par défaut, elle passe à EXPIRED, sans données de personne ni de contrôles — un bon état pour tester les messages de délai d'expiration de votre interface.
Une session annulée
Appelez DELETE /v1/sessions/{id} sur une session PENDING, puis essayez d'ouvrir verification_url. Confirmez que votre application traite une session annulée comme terminée, et non comme une erreur.
Paramètre régional français
Créez une session avec locale: "fr" et vérifiez que la page hébergée et votre propre gestion de l'URL de retour s'affichent correctement pour un demandeur francophone.
Limites
Ce que le bac à sable ne fait pas.
Des réponses claires, pas des petits caractères.
- Le bac à sable n'a pas de limite de débit distincte de celle de la production — aucune requête n'est actuellement limitée par des plafonds liés au forfait; cette application n'est pas encore en vigueur.
- Le bac à sable et la production sont distincts uniquement par le préfixe de clé, et non par des comptes, des tableaux de bord ou des jeux de documents distincts.
- Une session en bac à sable est une vraie vérification d'un vrai document. N'utilisez pas la pièce d'identité de quelqu'un d'autre pour tester — vérifiez la vôtre.
Questions
FAQ du bac à sable.
Obtenir une clé
Demandez une clé de bac à sable.
Dites-nous ce que vous développez et nous vous remettrons une clé pour commencer vos tests.
Les sessions du bac à sable ne sont jamais facturées.