> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Reenviar o cadastro de uma organização
> Abra uma nova tentativa de ativação para a mesma organização conectada sem mover produtos, customers ou histórico.
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](/platforms/resolve-activation-rejections). 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
| `activation_status` | Ação |
| ------------------- | ------------------------------------------------------------------- |
| `not_submitted` | Abra uma Activation Session. |
| `in_review` | Aguarde `organization.updated`; já existe uma análise em andamento. |
| `active` | Não reenvie; a organização já está apta. |
| `disabled` | Leia `requirements` antes de abrir outra tentativa. |
Quando o status estiver `disabled`:
| Sinal em `requirements` | Ação |
| ---------------------------------------------- | ------------------------------------------------------ |
| `disabled_reason: null` e `missing` preenchido | Corrija os campos indicados e tente novamente. |
| `disabled_reason` preenchido | Encaminhe ao suporte; não automatize novas tentativas. |
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.
Recupere `activation_status` e `requirements` ao [consultar a
organização](/api-reference/organizations/get).
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.
Envie o mesmo `org_*` em `POST /v1/activation-sessions`. Use sempre a URL
nova retornada pela API.
Processe `organization.updated` e consulte o objeto atual antes de alterar o
estado da conta no seu sistema.
```bash theme={"theme":"css-variables"}
curl -X POST "https://api.chargefy.io/v1/activation-sessions" \
-H "Authorization: Bearer {{PLATFORM_API_KEY}}" \
-H "Content-Type: application/json" \
-d '{
"organization": "org_TkVatKtpzcBx1kZL",
"return_url": "https://meusite.com/activation/return"
}'
```
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:
```bash theme={"theme":"css-variables"}
curl -X POST "https://api.chargefy.io/v1/organizations/org_TkVatKtpzcBx1kZL" \
-H "Authorization: Bearer {{PLATFORM_API_KEY}}" \
-H "Content-Type: application/json" \
-d '{
"document": "123.456.789-01"
}'
```
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}`](/api-reference/organizations/get) 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
Interprete `requirements`, códigos e caminhos de correção.
Consulte o contrato exato da nova sessão.