Skip to main content
Este guia mostra como iniciar outra tentativa de ativação para uma organização conectada que não foi aprovada. O objetivo é preservar o mesmo org_* e todo o contexto operacional já associado a ele. Para interpretar códigos, campos pendentes e motivos terminais, consulte Resolver reprovações de cadastro. Esta página trata apenas da tarefa de reenviar.

​
O que deve permanecer igual

A organização é o container estável da conta conectada. Uma nova tentativa de ativação não deve criar outra organização nem mover:
  • produtos e preços;
  • customers;
  • Checkout Sessions e Payment Intents;
  • assinaturas, faturas e histórico;
  • configuração de webhooks e referências do seu sistema.
Crie novas Activation Sessions sempre para o mesmo organization.

​
Decida se a organização pode tentar novamente

Quando o status estiver disabled: Repetir o mesmo cadastro sem corrigir missing pode terminar em outra reprovação e, quando a tentativa não for mais elegível, a criação da sessão retorna 409 activation_not_retryable.

​
Reenvie em quatro etapas

Para consultar e atualizar a organização, o org_* vai na URL de /v1/organizations/{id}. Não envie o header Organization nessas chamadas; esse header é usado nos recursos pertencentes à conta conectada.
1

Consulte a organização

Recupere activation_status e requirements ao consultar a organização.
2

Corrija os dados necessários

Use o motivo e a resolução documentados em requirements.errors. Se a correção exigir outro CPF/CNPJ e a troca ainda for permitida, atualize o documento antes de abrir a sessão. Só os caminhos presentes em requirements.missing são obrigatórios para a correção; os demais dados e arquivos válidos continuam associados à organização.
3

Crie uma Activation Session

Envie o mesmo org_* em POST /v1/activation-sessions. Use sempre a URL nova retornada pela API.
4

Acompanhe o resultado

Processe organization.updated e consulte o objeto atual antes de alterar o estado da conta no seu sistema.
A URL da sessão tem validade curta. Se expirar antes de ser aberta, crie outra sessão para a mesma organização. Na nova sessão, a Chargefy abre o formulário na etapa apontada pela reprovação. O item recusado volta vazio e precisa ser reenviado. Os demais dados permanecem preenchidos. Se a selfie não foi recusada, ela continua no componente de documentos e o vendedor pode mantê-la ou removê-la para enviar outra; depois de removida, a substituição é obrigatória para concluir.

​
Troque o documento somente quando permitido

Às vezes a correção exige mudar de CNPJ para CPF, corrigir um CPF ou usar outro CNPJ. Atualize o document no mesmo org_* antes da nova Activation Session:
A alteração é aceita somente quando todas estas condições são verdadeiras:
  • o status é not_submitted ou disabled;
  • não existe análise em andamento;
  • a organização ainda não possui atividade de pagamento;
  • o documento não pertence a outra organização conectada da mesma plataforma.
Depois da primeira ativação ou atividade de pagamento, o documento passa a identificar o histórico financeiro e não pode mais ser trocado.
Se a API retornar 409 document_already_in_use, use a organização já associada ao documento. Não crie uma duplicata para contornar a validação.

​
Acompanhe a nova tentativa

Escute estes eventos no endpoint da plataforma:
  • organization.review.required, quando uma atualização cadastral é necessária;
  • organization.review.submitted, quando o formulário hospedado é enviado;
  • organization.updated, quando status, requisitos ou dados públicos mudam.
Depois do reenvio, espere a organização passar para in_review. A aprovação leva a active; uma nova reprovação leva a disabled com os requisitos atualizados. Eventos podem ser repetidos ou chegar fora de ordem. Deduplique pelo event.id e confirme o estado com GET /v1/organizations/{id} antes de aplicar uma transição terminal.

​
O que não fazer

  • não crie outro org_* apenas porque uma tentativa foi reprovada;
  • não mova produtos, customers ou histórico para outra organização;
  • não reenvie enquanto o status estiver in_review;
  • não automatize novas tentativas quando disabled_reason for terminal;
  • não tente trocar o documento depois de existir histórico financeiro.

​
Próximos passos

Resolver reprovações

Interprete requirements, códigos e caminhos de correção.

Criar Activation Session

Consulte o contrato exato da nova sessão.