Um bureau de verificação de identidade com veredito explicável.

Envie um documento e uma selfie, rode liveness e conferência facial, cheque contra listas de sanções e PEP, e receba de volta approved, review ou rejected — com a cadeia de evidência completa por trás. Um guard em nível de código, não só um prompt, bloqueia aprovação automática sempre que falta evidência obrigatória.

O caso de uso

KYC como um pipeline assíncrono, não uma caixa preta.

Fazer onboarding de um cliente de serviço financeiro brasileiro significa provar que um documento é genuíno, que a pessoa apresentando ele é quem diz ser, e que ela não está em uma lista de sanções ou PEP — e depois conseguir mostrar ao seu regulador exatamente como você chegou nessa conclusão.

O pipeline de sete passos

O que vem na caixa

Verificação nível bureau, com evidência incluída.

Do upload ao veredito

Três chamadas: envie, submeta, consulte o caso.

O Native KYC é assíncrono por design — um caso percorre o pipeline em segundo plano; consulte `GET /v1/cases/{id}` ou espere o webhook.

1. 0. Peça as URLs de upload e os slots presigned do S3

   Peça URLs presigned do S3 para cada slot de imagem e envie direto para o S3 — nunca multipart para a própria API.

   Requisiçãobash

   curl -X POST https://api-kyc-hml.swepay.com.br/v1/cases/uploads \
     -H "Authorization: Bearer ${SWEPAY_JWT}" \
     -H "Content-Type: application/json" \
     -d '{ "slots": ["document_front", "document_back", "selfie"] }'

   Respostajson

   {
     "uploads": [
       { "slot": "document_front", "objectKey": "cases/tmp/8f3c.../front.jpg", "uploadUrl": "https://s3.sa-east-1.amazonaws.com/..." },
       { "slot": "document_back", "objectKey": "cases/tmp/8f3c.../back.jpg", "uploadUrl": "https://s3.sa-east-1.amazonaws.com/..." },
       { "slot": "selfie", "objectKey": "cases/tmp/8f3c.../selfie.jpg", "uploadUrl": "https://s3.sa-east-1.amazonaws.com/..." }
     ]
   }

2. 1. Inicie a sessão de liveness e submeta o caso

   Rode a captura de liveness contra o `sessionId` devolvido, depois submeta o caso com as chaves de objeto enviadas e esse `livenessSessionId`. Devolve `202 Accepted`.

   Requisiçãobash

   curl -X POST https://api-kyc-hml.swepay.com.br/v1/cases \
     -H "Authorization: Bearer ${SWEPAY_JWT}" \
     -H "Content-Type: application/json" \
     -d '{
       "cpf": "***.***.***-**",
       "documentType": "CNH",
       "documentFrontKey": "cases/tmp/8f3c.../front.jpg",
       "documentBackKey": "cases/tmp/8f3c.../back.jpg",
       "selfieKey": "cases/tmp/8f3c.../selfie.jpg",
       "livenessSessionId": "sess_8f21..."
     }'

   Respostajson

   HTTP/1.1 202 Accepted
   {
     "caseId": "c4d9e2a1-3b7f-4c1a-9e2d-1f6a7b8c9d0e",
     "status": "received"
   }

3. 2. Consulte o caso, ou espere o webhook

   Consulte status e evidência a qualquer momento, ou receba um webhook assinado por HMAC quando o caso chegar a um status final.

   Requisiçãojson

   curl https://api-kyc-hml.swepay.com.br/v1/cases/c4d9e2a1-3b7f-4c1a-9e2d-1f6a7b8c9d0e \
     -H "Authorization: Bearer ${SWEPAY_JWT}"

   Respostajson

   {
     "caseId": "c4d9e2a1-3b7f-4c1a-9e2d-1f6a7b8c9d0e",
     "status": "approved",
     "verdict": {
       "decision": "approved",
       "reasonSummary": "Document and face-match evidence within threshold; no sanctions match."
     },
     "evidence": [
       { "step": "DocumentExtraction", "status": "passed" },
       { "step": "DocumentIntegrity", "status": "passed" },
       { "step": "Liveness", "status": "passed", "score": 98.1 },
       { "step": "FaceMatch", "status": "passed", "score": 95.6 },
       { "step": "SourceConnectors", "status": "passed" },
       { "step": "Verdict", "status": "passed" }
     ]
   }

`api-kyc-hml.swepay.com.br` acima é ilustrativo — o Native KYC ainda não tem host público implantado (o pipeline está implementado; o onboarding no Marketplace Subscription Hub está pendente). Referência completa do pipeline e da política na página de desenvolvedores. Perguntas técnicas: engineering@swepay.com.br.

Segurança e conformidade

Evidência sem imagem.

O Native KYC trata alguns dos dados pessoais mais sensíveis que uma fintech lida — documento, CPF, rosto. Foi construído para reter evidência, não as imagens por trás dela.

Pricing

Dimensões por checagem, ou um plano mensal com volume incluído.

Cobrado inteiramente via AWS Marketplace. `kyc_basic` cobre o pipeline principal; adicione `kyc_official` só para os casos em que você configurou o Serpro.

Dimensões de uso

Todo plano abaixo inclui um pacote de checagens `kyc_basic`; uso acima do plano é cobrado por dimensão.

Planos mensais

Precificado por volume de checagens `kyc_basic`.

Qual eu preciso?

Native Biometrics vs. Native KYC

Produtos independentes (ADR-0003) que resolvem problemas diferentes e se integram bem juntos. A maioria das fintechs começa pelo que casa com o momento: fazer onboarding de um cliente novo, ou reverificar um que já conhecem.

Precisa dos dois? Assine cada um de forma independente no AWS Marketplace — não existe SKU combinado, e não há exigência de rodar um para usar o outro.

Perguntas frequentes

Antes de integrar.

Respostas diretas para as perguntas mais comuns antes de uma revisão de compliance.

Duas formas de começar.