Sandbox
Chaves de API sandbox para verificação de identidade.
Uma chave sandbox executa exatamente o mesmo fluxo de API, página hospedada e webhook da produção, em uma chave que nunca é cobrada. É a forma mais rápida de ver se o ShieldID atende você antes de falar de preços.
Como funciona
Mesmo pipeline. Chave diferente. Sem fatura.
O sandbox não é um modo de demonstração simplificado — é o pipeline de verificação real, separado apenas pela chave que você envia.
| Prefixo da chave | vk_sand_… identifica uma chave sandbox no momento da autenticação. Não há conta nem painel de sandbox separados para configurar. |
|---|---|
| Marca de ambiente | Toda sessão, resultado e webhook criado com uma chave sandbox carrega environment: "sandbox", de modo que nada criado no sandbox possa ser confundido com uma verificação real nas etapas seguintes. |
| Cobrança | As sessões de sandbox nunca são cobradas, em todos os planos, para quantas sessões você precisar para desenvolver e testar sua integração. |
| A verificação em si | Real: seu próprio documento, seu próprio rosto, as mesmas verificações. Não existe um conjunto separado de documentos de teste falsos — você verifica a si mesmo para ver como o produto se comporta. |
Como obter uma chave
Solicite uma hoje. O autoatendimento está chegando.
A criação de chaves sandbox por autoatendimento em planos elegíveis está planejada, mas ainda sem data. Até o lançamento, uma solicitação pelo formulário de contato lhe dá uma chave diretamente.
Hoje
Conte-nos um pouco sobre o que você está construindo no formulário de contato e entregaremos uma chave sandbox — a maioria dos pedidos no mesmo dia útil.
Em breve
Em breveA criação de chaves sandbox por autoatendimento, em planos elegíveis, está planejada, mas ainda sem data, para que você possa gerar uma chave assim que se cadastrar.
Experimente você mesmo
Cenários de teste que você pode executar no seu próprio celular.
Sem necessidade de documentos falsos — execute estes cenários com o seu próprio documento para ver como cada caminho realmente se comporta.
Uma aprovação limpa
Crie uma sessão, abra a página hospedada, fotografe o seu próprio documento e conclua o desafio de prova de vida. Veja checks.document, checks.liveness, checks.antispoof e checks.face_match retornarem PASS.
Uma câmera recusada
Negue a permissão da câmera quando a página hospedada solicitar. A sessão termina em FAILED com um failure_reason em torno do qual você pode criar uma mensagem de erro de verdade.
Uma nova tentativa após falha (em breve)
Reabrir a verification_url de uma sessão FAILED para redefini-la para PENDING e permitir uma segunda tentativa ainda não está disponível. Por enquanto, trate FAILED como estado final — crie uma nova sessão se o solicitante quiser tentar de novo.
Uma sessão expirada
Crie uma sessão e não toque nela. Após o prazo padrão, ela passa para EXPIRED, sem dados de pessoa ou de verificações — um bom estado para testar as mensagens de tempo esgotado da sua interface.
Uma sessão cancelada
Chame DELETE /v1/sessions/{id} em uma sessão PENDING e depois tente abrir a verification_url. Confirme que seu app trata uma sessão cancelada como concluída, e não como um erro.
Idioma francês
Crie uma sessão com locale: "fr" e confirme que a página hospedada e o tratamento da sua própria return-URL funcionam bem para um solicitante de língua francesa.
Limites
O que o sandbox não faz.
Respostas claras, sem letras miúdas.
- O sandbox não tem um limite de taxa separado da produção — atualmente nenhuma requisição é limitada por restrições de nível de plano; essa aplicação ainda não está ativa.
- Sandbox e produção são separados apenas pelo prefixo da chave, não por contas, painéis ou conjuntos de documentos distintos.
- Uma sessão de sandbox é uma verificação real de um documento real. Não use o documento de outra pessoa para testar — verifique o seu próprio.
Perguntas
Perguntas frequentes sobre o sandbox.
Obtenha uma chave
Solicite uma chave sandbox.
Conte-nos o que você está construindo e vamos providenciar uma chave para você começar a testar.
As sessões em sandbox nunca são cobradas.