PF ou PJ: qual fluxo usar

A diferença entre verificar uma pessoa (KYC) e uma empresa (KYB), campo por campo.

Tudo começa no mesmo endpoint: POST /applicants. O que muda é o profileType. Perfis que começam com pf_ verificam uma pessoa; perfis que começam com pj_ verificam uma empresa e, junto dela, o responsável legal.

  1. PF (KYC): profileType pf_br ou pf_intl. Envie fullName, cpf (ou o documento fiscal estrangeiro) e email. Documentos: identidade, selfie e o checklist da pessoa (residência, renda, ocupação).
  2. PJ (KYB): profileType pj_simples, pj_presumido, pj_real ou pj_intl. Envie também companyName, companyTaxId e declaredRevenue. fullName e cpf passam a ser do responsável legal.
  3. Em ambos, a resposta traz requiredDocuments e optionalDocuments — é a lista exata de docType que aquele caso precisa.
  4. No fluxo hospedado, a etapa de dados da empresa e os uploads complementares aparecem sozinhos quando o perfil é PJ.

PF — pessoa física no Brasil

await api("/api/public/kyc/v1/applicants", {
  method: "POST",
  body: {
    externalId: user.id,
    profileType: "pf_br",
    fullName: "Maria Silva",
    cpf: "12345678909",
    email: "maria@exemplo.com",
  },
});

PJ — empresa no Simples Nacional

await api("/api/public/kyc/v1/applicants", {
  method: "POST",
  body: {
    externalId: org.id,
    profileType: "pj_simples",
    companyName: "Padaria Aurora ME",
    companyTaxId: "12345678000199",
    declaredRevenue: 480000,
    fullName: "Maria Silva",   // responsável legal
    cpf: "12345678909",
  },
});
No painel, os casos aparecem separados: Pessoas (KYC) e Empresas (KYB), com o perfil de cada verificação na lista.
Próximo guiaVerificar uma empresa (KYB)