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..."
}
Suscripciones
Sesión del portal de facturación
Crea una sesión del portal de cliente de Stripe para gestionar la suscripción y los métodos de pago.
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
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_TOKENCuerpo 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 encabezadoAuthorization:
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
¿Esta página le ayudó?
⌘I