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

​
Descripción general

Crea una sesión de pago en Stripe para suscribirse a un plan. Devuelve una URL a la que debe redirigir al usuario para completar el pago. Requiere autenticación por sesión (token de acceso JWT).
Para integraciones de terceros: use POST /subscriptions/checkout/api con autenticación por clave API.

​
Autenticación

​
Authorization
string
requerido
Su token de acceso JWT. Formato: Bearer YOUR_ACCESS_TOKEN

​
Cuerpo de la solicitud

​
planId
string
requerido
Identificador del plan al que suscribirse. Debe ser uno de: starter, professional, business o agency.
​
billingCycle
string
predeterminado:"monthly"
Frecuencia de facturación. Opciones: monthly o yearly.
​
successUrl
string
URL de redirección tras un pago correcto. Por defecto, el panel de la aplicación.
​
cancelUrl
string
URL de redirección si el usuario cancela el pago. Por defecto, la página de precios.
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 de respuesta

​
sessionId
string
Identificador de la sesión de pago en Stripe. Puede usarse para verificar la sesión más adelante.
​
url
string
URL a la que redirigir al usuario para el pago. Es una página de pago alojada por Stripe.
​
plan
object
Detalles del plan seleccionado.

​
Flujo de pago

  1. Crear sesión: llame a este extremo con el plan deseado
  2. Redirigir al usuario: envíelo a la url devuelta
  3. Procesamiento del pago: el usuario completa el pago en Stripe
  4. Webhook: Stripe notifica a su extremo webhook
  5. Redirección de éxito: el usuario es redirigido a successUrl
  6. Verificación (opcional): compruebe el estado con /subscriptions/current

​
Respuestas de error

​
400
Solicitud incorrecta: identificador de plan no válido o el usuario ya tiene una suscripción activa.
​
401
No autorizado: token no válido o ausente.
Si el usuario ya tiene una suscripción activa, debe usar el portal de facturación (/subscriptions/portal) para cambiar de plan.

​
POST /subscriptions/checkout/api

Crea una sesión de pago en Stripe 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

​
Cuerpo de la solicitud

Igual que /subscriptions/checkout arriba.

​
Respuesta

Igual que /subscriptions/checkout arriba. 
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"
  }'