Saltar al contenido 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"
}

​
Descripción general

Cancela la suscripción del usuario. La suscripción sigue activa hasta el final del período de facturación actual y no se renovará. Requiere autenticación por sesión (token de acceso JWT).
Para integraciones de terceros: use POST /subscriptions/cancel/api con autenticación por clave API.
Esta acción programa la cancelación al final del período. El usuario conserva el acceso hasta currentPeriodEnd. Para una cancelación inmediata, use el portal de facturación.

​
Autenticación

​
Authorization
string
requerido
Su token de acceso JWT. 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 de respuesta

​
success
boolean
Indica si la cancelación se realizó correctamente.
​
message
string
Mensaje de estado legible.
​
cancellationDate
string
Marca de tiempo ISO 8601 en que finalizará la suscripción (solo si hubo éxito).

​
Respuestas de error

​
400
Solicitud incorrecta: el usuario no tiene suscripción activa que cancelar, o la suscripción no puede cancelarse vía API.
​
401
No autorizado: token no válido o ausente.

​
Comportamiento de la cancelación

EscenarioComportamiento
Suscripción activaCancelada y marcada como tal
Ya canceladaDevuelve error
Sin suscripciónDevuelve error
Sin identificador de suscripción en StripeDevuelve error (no se puede cancelar vía API)

​
Reactivación

Si el usuario desea reactivar, puede:
  1. Usar el portal de facturación (/subscriptions/portal)
  2. O crear una suscripción nueva cuando finalice la actual

​
Buenas prácticas

  • Diálogo de confirmación: confirme siempre antes de cancelar
  • Motivo: pregunte por qué cancela para obtener comentarios
  • Retención: valore ofrecer descuento u opción de pausa
  • Comunicación clara: indique cuándo terminará el acceso

​
POST /subscriptions/cancel/api

Cancela la suscripción del usuario mediante autenticación por clave API. Adecuado para integraciones de terceros.

​
Autenticación

Requiere autenticación por clave API. Incluya su clave en el encabezado Authorization: 
Authorization: Bearer llmgen_your_api_key_here

​
Respuesta

Igual que /subscriptions/cancel arriba. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel/api \
  -H "Authorization: Bearer llmgen_your_api_key_here"