Integração

Integre a trilha ao seu fluxo.

Dispare verificações, consulte dossiês e receba o status de cada Run direto no seu sistema. A API da kycert leva a trilha auditável para dentro do seu fluxo de onboarding, sem tela intermediária.

Quick start

Da chave de teste ao primeiro resultado.

Gere uma chave sk_test_ no dashboard, escolha um template e dispare um run com o documento do cliente. O resultado chega no seu webhook.

Autenticação por API key

Header x-api-key, com escopos por chave e ambiente sandbox.

Templates

O template define quais fontes e regras a verificação usa.

Resultado por webhook

O evento chega com a decisão e o risk band, assinado por HMAC.

Criar um run
curl -X POST https://admin.kycert.com.br/api/v1/bureau/runs \
  -H "x-api-key: sk_test_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "template_id": "SEU_TEMPLATE_ID",
        "subject": { "type": "pf", "doc": "00000000191" },
        "webhook_url": "https://seu-app.com/wh" }'

// 202 Accepted
{ "run_id": "550e8400-…440000",
  "status": "queued",
  "livemode": false }

O que a API resolve

Quando o onboarding acontece dentro do seu produto, a verificação precisa acontecer ali também. A API da kycert permite iniciar uma Run, acompanhar o resultado e puxar o dossiê programaticamente, enquanto os webhooks avisam o seu sistema a cada mudança de status.

Capacidades

Verificações via API

Inicie KYC e KYB pelo seu backend e receba o dossiê estruturado de volta.

Webhooks de status

Seja notificado em tempo real quando uma Run muda de estado, sem polling.

Livemode e créditos

Ambiente de teste e produção separados, com consumo de créditos rastreável por Run.

Dossiê programático

Acesse a evidência e a decisão registrada via API para anexar ao seu próprio fluxo de auditoria.

Exemplo

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

Onde se aplica

A API é o caminho para bancos e fintechs que embarcam a verificação em fluxos próprios por produto.

Bancos & fintechs →
kycert

Leve a trilha para dentro do seu fluxo.