Criar Sessão

Cria uma sessão de cliente via e-mail com magic link ou ID da organização.

Inicia uma sessão do portal do cliente. Envia um magic link por e-mail para autenticação sem senha.

​

Autenticação

Este endpoint não requer autenticação. É o ponto de entrada para obter um token de sessão.

​

Requisição

email · string · required

E-mail do cliente cadastrado na plataforma.

organization_id · string

ID da organização. Obrigatório quando o cliente pertence a múltiplas organizações.

return_url · string

URL de redirecionamento após autenticação via magic link.

cURL

curl -X POST https://api.chargefy.io/api/v1/customer-portal/sessions \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[e-mail]",
    "organization_id": "org_abc123",
    "return_url": "https://meusite.com.br/portal"
  }'

​

Resposta

token · string

Token de sessão do cliente (formato cst_xxx). Retornado apenas em ambiente sandbox.

Resposta 201

{
  "token": "cst_abc123def456"
}

Em ambiente de produção, o token não é retornado na resposta. O cliente recebe um magic link por e-mail para autenticação.