Sandbox

Visão Geral

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

Nenhum crédito real é debitado
OCR, face match e liveness são simulados
O resultado é determinado pelo external_id (tabelas abaixo)

Para ativar o sandbox:

Use uma API Key com prefixo sk_test_
Envie "ambiente": "sandbox" na criação da sessão

KYC — Resultados por `external_id`

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

No sandbox do KYC, qualquer imagem é aceita — a pipeline de OCR, face match e liveness é ignorada. O resultado é definido exclusivamente pelo external_id.

Auth 1:1 — Resultados por `external_id`

`external_id`	Resultado	`score_facial`	`score_liveness`
`11111111111`	`authenticated` (true)	0.92	0.95
`22222222222`	`rejected` — `facial_mismatch`	0.41	0.88
`33333333333`	`rejected` — `liveness_failed`	0.85	0.48
Qualquer outro valor	`authenticated` (true)	0.87	0.91

No sandbox do Auth, qualquer vídeo de selfie é aceito — o resultado é determinado pelo external_id da sessão. O embedding KYC também é simulado (não é necessário ter feito KYC antes em sandbox).

Comportamento Comparado

Comportamento	Sandbox	Produção
Créditos debitados	Não	Sim
Webhook disparado	Sim	Sim
Assinatura HMAC	Presente (se configurado)	Presente (se configurado)
OCR (KYC)	Ignorado	Executado
Face match	Ignorado	Executado
Liveness	Ignorado	Executado
Embedding KYC necessário para Auth	Não	Sim

Exemplo KYC em Sandbox

# 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/kyc"
  }'

# → Webhook com status "approved" e score_composto 95

Exemplo Auth 1:1 em Sandbox

# Criar sessão de autenticação
curl -X POST https://api-kyc.campeaosec.com/v1/auth/session \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "22222222222",
    "ambiente": "sandbox",
    "webhook_url": "https://seu-servidor.com/webhook/auth"
  }'

# → Webhook com authenticated: false, reason: "facial_mismatch"

Webhook no Sandbox

Os payloads têm o mesmo formato da produção. Exemplos:

KYC — `verification.completed`

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

Auth — `auth.completed`

{
  "event": "auth.completed",
  "auth_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
  "external_id": "11111111111",
  "authenticated": true,
  "status": "authenticated",
  "score_liveness": 0.95,
  "score_facial": 0.92,
  "reason": null,
  "ambiente": "sandbox",
  "created_at": "2026-07-31T10:00:00Z",
  "completed_at": "2026-07-31T10:00:01Z"
}

Primeiros Passos

KYC Verify

Auth 1:1

Visão Geral

KYC — Resultados por `external_id`

Auth 1:1 — Resultados por `external_id`

Comportamento Comparado

Exemplo KYC em Sandbox

Exemplo Auth 1:1 em Sandbox

Webhook no Sandbox

KYC — `verification.completed`

Auth — `auth.completed`

​Visão Geral

​KYC — Resultados por external_id

​Auth 1:1 — Resultados por external_id

​Comportamento Comparado

​Exemplo KYC em Sandbox

​Exemplo Auth 1:1 em Sandbox

​Webhook no Sandbox

​KYC — verification.completed

​Auth — auth.completed

Visão Geral

KYC — Resultados por `external_id`

Auth 1:1 — Resultados por `external_id`

Comportamento Comparado

Exemplo KYC em Sandbox

Exemplo Auth 1:1 em Sandbox

Webhook no Sandbox

KYC — `verification.completed`

Auth — `auth.completed`