Sandbox

Use uma chave sk_test_... para acessar o sandbox. Os mesmos endpoints de produção são usados — a chave determina o ambiente.

Sandbox usa as mesmas fontes e regras de produção. Os resultados são fictícios, mas o comportamento da API (status codes, headers, webhooks, erros) é idêntico ao de produção.

CPFs de teste

CPF	Cenário	`decision`	`risk_band`
`000.000.001-91`	Perfil limpo	`approved`	`baixo`
`000.000.002-81`	CPF cancelado (bloqueio fase crítica)	`rejected`	`alto`
`000.000.003-72`	Mandado de prisão ativo	`rejected`	`alto`
`000.000.004-53`	PEP ativo	`review`	`alto`
`000.000.005-44`	Sanção OFAC	`rejected`	`alto`
`000.000.006-34`	Protestos financeiros	`review`	`alto`
`000.000.007-25`	Improbidade administrativa	`review`	`alto`
`000.000.008-06`	Fontes parciais (timeout em 3 fontes)	`review`	`medio`
`000.000.009-87`	Todos os flags negativos	`rejected`	`alto`
`000.000.010-64`	Sanção com match 72%/0% — homônimo, não bloqueia automaticamente	`review`	`alto`
`000.000.011-55`	Sanção de parente de 1º grau abaixo do match mínimo — não bloqueia o titular	`review`	`alto`
`000.000.012-46`	Mandado de prisão com match de nome 80% (divergente) — não bloqueia automaticamente	`review`	`alto`
`000.000.013-37`	Mandado de prisão com nome idêntico — bloqueia normalmente	`rejected`	`alto`
`000.000.014-28`	Sanção de terrorismo com nome divergente — não bloqueia automaticamente	`review`	`alto`
`000.000.015-19`	Sanção de terrorismo com nome idêntico — bloqueia normalmente	`rejected`	`alto`
`000.000.016-78`	Volume de processos judiciais próximo do teto de truncamento (`LAWSUITS_CAP`)	`?` †	`?` †

CNPJs de teste

CNPJ	Cenário	`decision`	`risk_band`
`00.000.000/0001-91`	Empresa limpa	`approved`	`baixo`
`00.000.000/0002-76`	Sanção crime financeiro (OFAC)	`rejected`	`alto`
`00.000.000/0003-57`	PEP societário (exposição via sócios)	`review`	`alto`
`00.000.000/0004-81`	Processo CVM (Judged Sanctions)	`rejected`	`alto`
`00.000.000/0005-15`	Volume de processos judiciais próximo do teto de truncamento (`LAWSUITS_CAP`), pessoa jurídica	`?` †	`?` †

† decision/risk_band destes dois cenários (pf_processes_cap/pj_processes_cap, fix-320) não foram confirmados nesta revisão — o propósito original do fixture é testar o truncamento do log bureau_lawsuits_truncated, não uma decisão específica. Rode uma consulta sandbox com esse CPF/CNPJ para confirmar antes de documentar um valor definitivo.

Exemplo de uso

curl -X POST https://admin.kycert.com.br/api/v1/bureau/runs \
  -H "x-api-key: sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "SEU_TEMPLATE_ID",
    "subject": {
      "type": "pf",
      "doc": "00000000191"
    },
    "external_id": "test_cust_001"
  }'

O template_id deve ser um template real do seu tenant — crie um no dashboard antes de testar.

Começando

Guias

Webhooks

Verificação Facial

Referência da API

CPFs de teste

CNPJs de teste

Exemplo de uso

​CPFs de teste

​CNPJs de teste

​Exemplo de uso

CPFs de teste

CNPJs de teste

Exemplo de uso