Guia rápido

Cinco passos da criação da chave até o resultado da verificação.

1. Crie uma chave de API

# Admin -> API Keys -> Nova chave
export VERIFY_API_KEY="kyc_live_xxx"

2. Crie o candidato

curl -X POST "https://SEU-DOMINIO/api/public/kyc/v1/applicants" \
  -H "X-API-Key: $VERIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalId":"user-42","fullName":"Maria Silva","email":"maria@exemplo.com","isTest":true}'

# -> { "applicantId": "uuid", "status": "created" }

3. Crie a sessão de verificação

curl -X POST "https://SEU-DOMINIO/api/public/kyc/v1/applicants/APPLICANT_ID/session" \
  -H "X-API-Key: $VERIFY_API_KEY"

# -> { "url": "https://SEU-DOMINIO/verify?token=...", "expiresAt": "..." }

4. Abra o fluxo para o usuário

<iframe src={session.url} allow="camera; geolocation"
        style={{ width: "100%", height: 720, border: 0 }} />

5. Leia o resultado

curl "https://SEU-DOMINIO/api/public/kyc/v1/applicants/APPLICANT_ID" \
  -H "X-API-Key: $VERIFY_API_KEY"

# -> { "status": "approved", "reason": null, "checks": [ ... ] }

Use isTest: true enquanto integra — essas verificações não entram no faturamento.