customer_portal.session é uma autorização temporária para um customer
abrir o portal hospedado da Chargefy. Ela não cria uma conta de login no seu
produto e não substitui os objetos canônicos customer, subscription,
invoice e payment_method. O portal é só a experiência hospedada onde o
cliente final executa uma ação segura.
O termo session significa que a Chargefy criou uma página hospedada com
autorização embutida, escopo definido e expiração curta. Depois de criar a
sessão no seu servidor, redirecione o cliente para a url, por exemplo:
Objeto customer_portal.session
Este é o formato completo retornado emcreate. A url inicial contém um
authorization_code válido até expires_at ou a conclusão da solicitação.
Vencimento fixo do link, contado desde a emissão. Abrir ou reabrir não altera
esse valor; a duração do acesso no navegador é controlada separadamente.
URL hospedada da Chargefy. Redirecione o cliente para essa URL logo após criar
a sessão. O link contém uma autorização temporária e não deve ser salvo como
link permanente.
Flows comuns
Como processar
- Crie a sessão no seu servidor com
POST /v1/customer-portal-sessions. - Redirecione o cliente para
urlimediatamente. - Depois da conclusão, use webhooks dos objetos alterados para atualizar seu sistema. O portal não emite um evento próprio no V1.
Expiração
Semflow_data, o link vale 1 hora e exige confirmação pelo e-mail cadastrado.
Com flow_data, vale 30 dias e autoriza somente a solicitação indicada, até sua
conclusão. As regras são iguais para painel e API.
Abrir não altera a data de vencimento. O acesso do navegador encerra após
1 hora sem atividade, limitado pelo vencimento do link. Uma solicitação pendente
pode ser reaberta enquanto seu link estiver válido; uma concluída mostra a
confirmação e não permite novas alterações.

