Sandbox - Campeão Sec

Visão Geral

O sandbox é um ambiente isolado para desenvolvimento e integração. Nenhum crédito real é debitado, mas o fluxo completo é executado — sessão, widget, webhook — exatamente como em produção. Para usar o sandbox:

Use uma API Key com prefixo sk_test_
Envie "ambiente": "sandbox" na criação da sessão
Use os CPFs mágicos abaixo no campo external_id

CPFs Mágicos — KYC

O external_id determina o resultado da verificação no sandbox. Use esses valores para testar cada cenário:

`external_id`	Status retornado	`score_composto`
`11111111111`	`approved`	95
`22222222222`	`rejected`	20
`33333333333`	`manual_review`	65
Qualquer outro valor	`approved`	80

O webhook é disparado normalmente após a conclusão — use 22222222222 para simular a notificação de uma rejeição.

Documentos de Teste

No sandbox, qualquer imagem é aceita — a pipeline de OCR, face match e liveness é ignorada. Você pode usar uma foto qualquer para completar o fluxo do widget. O resultado é determinado exclusivamente pelo external_id da sessão.

Comportamento do Sandbox

Evento	Sandbox	Produção
OCR	Ignorado	Executado
Face match	Ignorado	Executado
Liveness	Ignorado (qualquer vídeo passa)	Executado
Crédito KYC	Não debitado	Debitado
Webhook	Disparado normalmente	Disparado normalmente
Assinatura HMAC	Presente (se configurado)	Presente (se configurado)

Exemplo Completo em Sandbox

# 1. Criar sessão — external_id define o resultado
curl -X POST https://api-kyc.campeaosec.com/v1/verify/session \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "BR",
    "external_id": "11111111111",
    "ambiente": "sandbox",
    "webhook_url": "https://seu-servidor.com/webhook"
  }'

# Resposta:
# {
#   "session_token": "abc123...",
#   "expira_em": "2026-07-30T11:00:00Z"
# }

# 2. Passar o session_token para o widget no frontend
# 3. Webhook será recebido com status "approved" e score_composto 95

Webhook no Sandbox

O payload do webhook no sandbox tem o mesmo formato da produção, com "modo": "FULL_KYC" e scores fixos conforme a tabela de CPFs mágicos.

{
  "event": "verification.completed",
  "verification_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "external_id": "11111111111",
  "status": "approved",
  "country": "BR",
  "modo": "FULL_KYC",
  "created_at": "2026-07-30T10:00:00Z",
  "completed_at": "2026-07-30T10:00:01Z",
  "scores": {
    "composto": 95,
    "face_match": null,
    "liveness": null,
    "antifraude": null
  },
  "ocr": {
    "nome": null,
    "documento_numero": null,
    "data_nascimento": null
  }
}

​Visão Geral

​CPFs Mágicos — KYC

​Documentos de Teste

​Comportamento do Sandbox

​Exemplo Completo em Sandbox

​Webhook no Sandbox