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..."
}

Documentation Index

Fetch the complete documentation index at: https://docs.llmgenerator.com/llms.txt

Use this file to discover all available pages before exploring further.

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