Saltar al contenido principal
POST
/
subscriptions
/
portal
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Descripción general

Crea una sesión del Customer Portal de Stripe donde los usuarios pueden:
  • Actualizar métodos de pago
  • Ver el historial de facturación
  • Cambiar de plan de suscripción
  • Descargar facturas
  • Cancelar la suscripción
Requiere autenticación por sesión (token de acceso JWT).
Para integraciones de terceros: use POST /subscriptions/portal/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

​
returnUrl
string
URL de redirección al salir del portal. Por defecto, el panel de la aplicación.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Campos de respuesta

​
url
string
URL a la que redirigir al usuario. Es el portal de facturación alojado por Stripe.

​
Capacidades del portal

El Customer Portal de Stripe permite a los usuarios:
FunciónDescripción
Métodos de pagoAñadir, actualizar o eliminar tarjetas
FacturasVer y descargar facturas anteriores
Cambio de planMejorar o reducir la suscripción
CancelaciónCancelar la suscripción
Historial de facturaciónVer todas las transacciones anteriores

​
Respuestas de error

​
400
Solicitud incorrecta: no se encontró cuenta de facturación. El usuario debe haber realizado una compra antes.
​
401
No autorizado: token no válido o ausente.
El portal de facturación solo está disponible para usuarios que ya han realizado una compra o tienen una suscripción activa. Los usuarios nuevos deben usar el extremo de pago (checkout).

​
POST /subscriptions/portal/api

Crea una sesión del Customer Portal de 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/portal arriba.

​
Respuesta

Igual que /subscriptions/portal arriba. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

​
Buenas prácticas

  • Enlace en ajustes: añada un botón «Gestionar facturación» en la página de ajustes
  • Tras el checkout: redirija al portal tras la compra de la suscripción
  • Soporte: ofrezca acceso al portal como opción de autoservicio para temas de facturación