Sesión del portal de facturació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"
  }'

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

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

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

{
  "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

string

requerido

Su token de acceso JWT. Formato: Bearer YOUR_ACCESS_TOKEN

Cuerpo de la solicitud

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

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

Campos de respuesta

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ón	Descripción
Métodos de pago	Añadir, actualizar o eliminar tarjetas
Facturas	Ver y descargar facturas anteriores
Cambio de plan	Mejorar o reducir la suscripción
Cancelación	Cancelar la suscripción
Historial de facturación	Ver todas las transacciones anteriores

Respuestas de error

Solicitud incorrecta: no se encontró cuenta de facturación. El usuario debe haber realizado una compra antes.

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

const response = await fetch('https://api.llmgenerator.com/api/v1/subscriptions/portal/api', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer llmgen_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnUrl: 'https://yourapp.com/settings/billing'
  })
});

const data = await response.json();
// Redirect user to Stripe portal
window.location.href = data.url;

import requests

response = requests.post(
    'https://api.llmgenerator.com/api/v1/subscriptions/portal/api',
    headers={
        'Authorization': 'Bearer llmgen_your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'returnUrl': 'https://yourapp.com/settings/billing'
    }
)
data = response.json()
print(f"Redirect to: {data['url']}")

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

Primeros pasos

Integraciones

Referencia de la API

Sesión del portal de facturación

Descripción general

Autenticación

Cuerpo de la solicitud

Campos de respuesta

Capacidades del portal

Respuestas de error

POST /subscriptions/portal/api

Autenticación

Cuerpo de la solicitud

Respuesta

Buenas prácticas

​Descripción general

​Autenticación

​Cuerpo de la solicitud

​Campos de respuesta

​Capacidades del portal

​Respuestas de error

​POST /subscriptions/portal/api

​Autenticación

​Cuerpo de la solicitud

​Respuesta

​Buenas prácticas

Descripción general

Autenticación

Cuerpo de la solicitud

Campos de respuesta

Capacidades del portal

Respuestas de error

POST /subscriptions/portal/api

Autenticación

Cuerpo de la solicitud

Respuesta

Buenas prácticas