activation_session representa uma sessão hospedada para ativar ou reativar o perfil financeiro de uma organization conectada a uma plataforma. A sessão pertence a uma plataforma, aponta para uma organização existente e entrega uma URL temporária para o fluxo hospedado.
activation_session também é um recurso exclusivo do Chargefy for Platforms.
Criar e consultar sessões exige uma API key de plataforma com escopo
platform_admin.session aqui não é uma sessão do seu backend nem um login permanente. É uma instância temporária de uma página hospedada pela Chargefy, com autorização embutida, para que o vendedor conectado preencha cadastro, dados de negócio, documentos e informações bancárias sem você precisar montar esse formulário. Depois de criar a sessão, redirecione o vendedor para a url, por exemplo:
return_url para trazer o vendedor de volta ao seu produto quando ele concluir ou sair do fluxo.
O passo a passo completo — criação, redirect, eventos, resultado e reenvio — está no guia Ativar organização por sessão hospedada.
O status financeiro não fica no objeto activation_session. Consulte GET /v1/organizations/{id} ou acompanhe organization.updated para ler organization.activation_status. Se o cadastro for reprovado, o motivo e a instrução de correção também chegam pela organização, em organization.requirements — veja Requisitos de ativação.
Data Object
Este é o formato completo retornado emcreate e em get.
Estado da sessão.
A sessão percorre
created, in_progress e submitted. O status da sessão não descreve o estado financeiro: para saber se a conta foi aprovada, reprovada ou permite novo envio, consulte a organization.URL hospedada com
authorization_code de uso único. No GET e em estados
fechados, vem null.Operações
Eventos
A sessão não emite evento próprio. O resultado chega pela organização conectada: o envio para análise aparece emorganization.activation_status como in_review, a aprovação como active e, em caso de reprovação, motivo e instrução em organization.requirements.
