Skip to main content

Obtener URLs de checkout para planes de suscripción

GET 
/company/payment/urls

Purpose​

Genera URLs de sesión de checkout de Stripe para cada plan de suscripción disponible, listas para redirigir al usuario.

Objective​

Proporcionar al frontend los enlaces directos a Stripe Checkout para que la compañía pueda seleccionar y pagar un plan de suscripción.

Use Cases​

  • Mostrar tarjetas de planes con botones "Suscribirse"
  • Redirigir al usuario a Stripe Checkout para completar el pago
  • Presentar comparativa de planes disponibles con sus precios

Validation Flow​

flowchart TD
  A[Receive Request] --> B{User authenticated?}
  B -->|No| C[404 USER_NOT_FOUND]
  B -->|Yes| D{Company found?}
  D -->|No| E[401 CIA_NOT_FOUND]
  D -->|Yes| F[Fetch plans from DB]
  F --> G[Fetch Stripe prices]
  G --> H[Create Checkout sessions per plan]
  H --> I[200 OK - Plans + URLs]

Notes​

  • Requiere autenticación JWT (bearerAuth)
  • Si la compañía tiene stripe_customer, lo asocia a la sesión
  • Si no tiene stripe_customer, usa el email de invoice_data.email
  • La URL de retorno es fija: ${HOST_FRONT}/admin/config
  • Modo de suscripción: subscription (no pago único)
  • Incluye client_reference_id con referencia de la compañía

Request​

Responses​

Lista de planes con URLs de checkout de Stripe

Response Headers