FluxaFluxa
Entrar

Verificar uma empresa (KYB)

Crie a verificação com o perfil da empresa e envie os documentos do checklist do regime tributário.

  1. Escolha o profileType da empresa: pj_simples, pj_presumido, pj_real ou pj_intl.
  2. Crie o candidato com companyName, companyTaxId e declaredRevenue; a resposta devolve requiredDocuments.
  3. Envie o documento de identidade e a selfie do responsável legal, como em qualquer KYC.
  4. Envie cada docType do checklist (imagem ou PDF) — ou use o fluxo hospedado, que já pede tudo.
  5. Dispare a análise e leia as checagens doc:<docType> no detalhe do candidato.

Criar a verificação da empresa

const applicant = await api("/api/public/kyc/v1/applicants", {
  method: "POST",
  body: {
    externalId: org.id,
    fullName: org.legalRepName,          // responsável legal
    cpf: org.legalRepCpf,
    profileType: "pj_simples",
    companyName: "Padaria Aurora ME",
    companyTaxId: "12345678000199",
    declaredRevenue: 480000,
  },
});
// -> { applicantId, profileType, requiredDocuments: [...], optionalDocuments: [...] }

Enviar um documento do checklist

await api(`/api/public/kyc/v1/applicants/${applicant.applicantId}/documents`, {
  method: "POST",
  body: {
    docType: "articles_of_incorporation",
    contentBase64: pdfBase64,
    mimeType: "application/pdf",
  },
});

await api(`/api/public/kyc/v1/applicants/${applicant.applicantId}/submit`, { method: "POST" });
A lista completa de docType por perfil está em Perfis e documentos. Um valor inválido retorna 400 com o array allowed.
Documento obrigatório ausente ou reprovado impede a aprovação automática: o caso vai para revisão manual. Sócios e beneficiário final passam por KYC individual.