Portal de cobrança

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

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

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

{
  "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

string

obrigatório

Seu JWT de acesso. Formato: Bearer YOUR_ACCESS_TOKEN

Corpo da requisição

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

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

Campos da resposta

string

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

Recursos do portal

O Stripe Customer Portal permite:

Recurso	Descrição
Métodos de pagamento	Adicionar, atualizar ou remover cartões
Faturas	Visualizar e baixar faturas anteriores
Alteração de plano	Upgrade ou downgrade
Cancelamento	Cancelar assinatura
Histórico	Ver todas as transações anteriores

Respostas de erro

Requisição inválida — não há conta de cobrança. É necessário ter feito uma compra antes.

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal/api', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer llmgen_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal/api',
    headers={
        'Authorization': 'Bearer llmgen_your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

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

Introdução

Integrações

Referência da API

Visão geral

Autenticação

Corpo da requisição

Campos da resposta

Recursos do portal

Respostas de erro

POST /subscriptions/portal/api

Autenticação

Corpo da requisição

Resposta

Boas práticas

​Visão geral

​Autenticação

​Corpo da requisição

​Campos da resposta

​Recursos do portal

​Respostas de erro

​POST /subscriptions/portal/api

​Autenticação

​Corpo da requisição

​Resposta

​Boas práticas

Visão geral

Autenticação

Corpo da requisição

Campos da resposta

Recursos do portal

Respostas de erro

POST /subscriptions/portal/api

Autenticação

Corpo da requisição

Resposta

Boas práticas