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

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