Pular para o conteúdo principal
POST
/
subscriptions
/
cancel
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

​
Visão geral

Cancela a assinatura do usuário. Ela permanece ativa até o fim do período de cobrança atual e não será renovada. Exige autenticação por sessão (JWT de acesso).
Para integrações de terceiros: use POST /subscriptions/cancel/api com autenticação por chave de API.
O cancelamento é agendado para o fim do período. O acesso se mantém até currentPeriodEnd. Para cancelamento imediato, use o portal de cobrança.

​
Autenticação

​
Authorization
string
obrigatório
Seu JWT de acesso. Formato: Bearer YOUR_ACCESS_TOKEN
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

​
Campos da resposta

​
success
boolean
Se o cancelamento foi bem-sucedido.
​
message
string
Mensagem de status legível.
​
cancellationDate
string
Data e hora em ISO 8601 em que a assinatura terminará (apenas em caso de sucesso).

​
Respostas de erro

​
400
Requisição inválida — sem assinatura ativa ou cancelamento indisponível por API.
​
401
Não autorizado — token ausente ou inválido.

​
Comportamento do cancelamento

CenárioComportamento
Assinatura ativaCancelada e marcada conforme política
Já canceladaRetorna erro
Sem assinaturaRetorna erro
Sem ID Stripe da assinaturaRetorna erro (cancelamento por API indisponível)

​
Reativação

Para reativar, o usuário pode:
  1. Usar o portal de cobrança (/subscriptions/portal)
  2. Ou contratar nova assinatura após o término da atual

​
Boas práticas

  • Diálogo de confirmação: confirme antes de cancelar
  • Motivo: colete o motivo para feedback
  • Retenção: considere desconto ou pausa
  • Comunicação: mostre claramente quando o acesso termina

​
POST /subscriptions/cancel/api

Cancela a assinatura com autenticação por chave de API. Indicado para integrações externas.

​
Autenticação

Authorization: Bearer llmgen_your_api_key_here

​
Resposta

Igual à de /subscriptions/cancel, acima. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel/api \
  -H "Authorization: Bearer llmgen_your_api_key_here"