Skip to main content

​
O que é KYC?

KYC (Know Your Customer) é o processo de verificação de identidade usado na ativação financeira. Ele confirma os dados do titular ou responsável legal e vincula a organização à conta bancária em que receberá os valores.
A verificação KYC é obrigatória para processar pagamentos reais. A organização precisa chegar a activation_status: "active" antes de confirmar cobranças e receber liquidações na conta para saques cadastrada.

​
Por que é necessário?

A verificação permite que a infraestrutura financeira integrada:
  • identifique o titular ou responsável legal;
  • valide a titularidade dos dados e da conta bancária;
  • aplique os controles de risco e conformidade necessários à ativação;
  • informe se o cadastro foi aprovado ou se precisa de correção.

​
Processo de verificação

Na primeira ativação, a página hospedada conduz o titular ou responsável legal pelas etapas aplicáveis ao seu cadastro:
1

Dados do negócio

Informe o tipo de cadastro (CPF ou CNPJ), os dados da atividade e o endereço. Para CNPJ, também são coletados os dados cadastrais da empresa.
2

Titular ou responsável legal

Informe nome civil, CPF, data de nascimento, contato e endereço do titular (PF) ou do responsável legal (PJ).
3

Verificação de identidade

Envie uma selfie e um documento de identidade aceito. A selfie é uma foto separada: não é necessário segurar o documento.
4

Conta para saques

Cadastre uma conta corrente ou poupança da mesma titularidade do CPF ou CNPJ informado.
5

Revisão e envio

Revise os dados e envie o cadastro. A sessão hospedada passa para submitted, enquanto a organização entra em in_review.
6

Resultado

A organização passa para active quando aprovada ou disabled quando há uma reprovação. O resultado chega no objeto organization e no webhook organization.updated.
Para plataformas, esse formulário é aberto por uma activation_session. A Chargefy entrega uma URL temporária e coleta os dados sem que a plataforma precise construir o formulário. Veja o passo a passo em Ativação hospedada. Plataformas que preferem manter o cadastro dentro do próprio produto também podem coletar e enviar os mesmos dados pela Ativação por API. Os dois caminhos atualizam a mesma organização e entregam o resultado por organization.updated.

​
Dados solicitados

O fluxo de ativação atual não exige upload de comprovante de endereço, contrato social, Requerimento de Empresário ou documentos dos sócios. Os endereços são informados diretamente no formulário.

​
Documentos de identidade

O titular (PF) ou responsável legal (PJ) envia:
O documento deve ser original, colorido, válido e estar inteiro na imagem, com todas as bordas e dados legíveis. Evite cortes, reflexos, sombras e fotos desfocadas. Imagens podem ter até 20 MB e são reduzidas automaticamente; PDFs podem ter até 5 MB.

​
Prazos de Análise

A análise normalmente termina em minutos. Casos que exigem verificação adicional podem levar mais tempo, por isso não use um prazo fixo para liberar recebimentos: aguarde activation_status: "active" no objeto ou no webhook organization.updated. Documentos legíveis e dados consistentes reduzem a chance de nova solicitação.

​
Status de Verificação

O andamento da verificação é refletido no campo activation_status da organização:

​
Consultar Status via API

Consulte GET /v1/organizations/{id} na API Reference ou acompanhe o webhook organization.updated. O evento entrega o objeto atualizado sempre que o estado financeiro muda.
activation_session.status acompanha apenas o preenchimento da página hospedada (created, in_progress e submitted). organization.activation_status é a fonte de verdade para saber se a conta foi aprovada (active), está em análise (in_review) ou precisa de ação (disabled).

​
O Que Fazer em Caso de Rejeição

Quando activation_status for disabled, leia organization.requirements antes de abrir uma nova tentativa:
1

Leia as pendências

errors explica o motivo, missing aponta os campos que precisam ser corrigidos e disabled_reason informa se ainda existe reenvio pelo fluxo normal.
2

Corrija somente o necessário

Atualize os dados, a selfie, o documento de identidade ou a conta para saques indicados em missing.
3

Inicie uma nova tentativa

Quando disabled_reason for null, mantenha a mesma organização. No fluxo hospedado, crie outra activation session; no fluxo por API, atualize os caminhos de missing e chame /submit novamente.
4

Acompanhe o resultado

Aguarde a transição para in_review e depois active ou disabled em organization.updated. Se disabled_reason estiver preenchido, não crie sessões em loop; encaminhe o caso ao suporte.

​
Motivos Comuns de Rejeição

​
Perguntas Frequentes

Você pode preparar produtos, preços e o código da integração. Criar ou confirmar recursos de pagamento — inclusive no sandbox — exige que a organização esteja active. A Chargefy não mantém um saldo aguardando saque enquanto o cadastro está pendente.
A verificação é feita na ativação inicial, mas a Chargefy pode solicitar atualização de dados ou documentos por mudança cadastral, análise de risco ou exigência regulatória. Nesses casos, acompanhe organization.requirements.
Sim. Os arquivos de KYC são privados e têm acesso controlado. O tratamento desses dados segue as regras de segurança e privacidade aplicáveis, incluindo a LGPD.
Não no fluxo de ativação atual. O endereço é informado no formulário, e o cadastro não pede upload de comprovante de endereço, contrato social, Requerimento de Empresário ou documentos dos sócios.
A selfie ajuda a confirmar que o titular ou responsável legal é a mesma pessoa do documento de identidade enviado. Ela deve ser tirada separadamente, com fundo neutro e boa iluminação — sem segurar o documento.