Skip to main content
POST

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

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

Cuerpo de la solicitud

string
requerido
Identificador del plan al que suscribirse. Debe ser uno de: starter, professional, business o agency.
string
predeterminado:"monthly"
Frecuencia de facturación. Opciones: monthly o yearly.
string
URL de redirección tras un pago correcto. Por defecto, el panel de la aplicación.
string
URL de redirección si el usuario cancela el pago. Por defecto, la página de precios.

Campos de respuesta

string
Identificador de la sesión de pago en Stripe. Puede usarse para verificar la sesión más adelante.
string
URL a la que redirigir al usuario para el pago. Es una página de pago alojada por Stripe.
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

Solicitud incorrecta: identificador de plan no válido o el usuario ya tiene una suscripción activa.
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:

Cuerpo de la solicitud

Igual que /subscriptions/checkout arriba.

Respuesta

Igual que /subscriptions/checkout arriba.