Pular para o conteúdo principal
POST
/
subscriptions
/
checkout
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'
{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

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 Stripe Checkout para assinatura de um plano. Retorna uma URL para redirecionar o usuário ao pagamento. Exige autenticação por sessão (JWT de acesso).
Para integrações de terceiros: use POST /subscriptions/checkout/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

planId
string
obrigatório
Identificador do plano: starter, professional, business ou agency.
billingCycle
string
padrão:"monthly"
Periodicidade de cobrança: monthly ou yearly.
successUrl
string
URL após pagamento bem-sucedido. Por padrão, dashboard do aplicativo.
cancelUrl
string
URL se o usuário cancelar. Por padrão, página de preços.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'
{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

Campos da resposta

sessionId
string
ID da sessão Stripe Checkout. Pode ser usado para verificação posterior.
url
string
URL para redirecionar o usuário ao checkout hospedado pela Stripe.
plan
object
Detalhes do plano selecionado.

Fluxo de checkout

  1. Criar sessão: chame este endpoint com o plano desejado
  2. Redirecionar: envie o usuário para a url retornada
  3. Pagamento: o usuário conclui na Stripe
  4. Webhook: a Stripe notifica seu endpoint de webhook
  5. Sucesso: redirecionamento para successUrl
  6. Verificação (opcional): estado em /subscriptions/current

Respostas de erro

400
Requisição inválida — plano inválido ou usuário já possui assinatura ativa.
401
Não autorizado — token ausente ou inválido.
Se já existir assinatura ativa, use o portal de cobrança (/subscriptions/portal) para alterar plano.

POST /subscriptions/checkout/api

Cria sessão Stripe Checkout 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/checkout, acima.

Resposta

Igual ao de /subscriptions/checkout, acima.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'