Pular para o conteúdo principal
POST
/
subscriptions
/
portal
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Visão geral

Cria uma sessão do Stripe Customer Portal onde o usuário pode:
  • Atualizar métodos de pagamento
  • Ver histórico de cobrança
  • Alterar plano de assinatura
  • Baixar faturas
  • Cancelar assinatura
Exige JWT de sessão.
Para integrações de terceiros: use POST /subscriptions/portal/api com autenticação por chave de API.

​
Autenticação

​
Authorization
string
obrigatório
Seu JWT de acesso. Formato: Bearer YOUR_ACCESS_TOKEN

​
Corpo da requisição

​
returnUrl
string
URL ao sair do portal. Por padrão, dashboard do aplicativo.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Campos da resposta

​
url
string
URL para redirecionar o usuário ao portal de cobrança hospedado pela Stripe.

​
Recursos do portal

O Stripe Customer Portal permite:
RecursoDescrição
Métodos de pagamentoAdicionar, atualizar ou remover cartões
FaturasVisualizar e baixar faturas anteriores
Alteração de planoUpgrade ou downgrade
CancelamentoCancelar assinatura
HistóricoVer todas as transações anteriores

​
Respostas de erro

​
400
Requisição inválida — não há conta de cobrança. É necessário ter feito uma compra antes.
​
401
Não autorizado — token ausente ou inválido.
O portal só está disponível para quem já comprou ou possui assinatura ativa. Novos usuários devem usar o endpoint de checkout.

​
POST /subscriptions/portal/api

Cria sessão do Stripe Customer Portal com chave de API. Indicado para integrações externas.

​
Autenticação

Authorization: Bearer llmgen_your_api_key_here

​
Corpo da requisição

Igual ao de /subscriptions/portal, acima.

​
Resposta

Igual ao de /subscriptions/portal, acima. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

​
Boas práticas

  • Configurações: botão “Gerenciar cobrança” na área de configurações
  • Pós-checkout: oferecer acesso ao portal após a assinatura
  • Suporte: autoatendimento para questões de faturamento