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

Documentation Index

Fetch the complete documentation index at: https://docs.llmgenerator.com/llms.txt

Use this file to discover all available pages before exploring further.

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