Suscripciones

Suscripciones

La función de suscripciones define las operaciones de suscripción y plan del propietario de la cuenta expuestas a través de Inbox Manager rutas proxy. Ofrece a los propietarios un control directo del ciclo de vida del plan y, al mismo tiempo, mantiene estrictas comprobaciones de cuentas y funciones.

Por qué esto importa

Esta característica consolida las acciones de suscripción del propietario bajo la superficie API Inbox Manager y al mismo tiempo preserva estrictas verificaciones de cuentas y funciones de las reclamaciones de tokens de portador. Expone operaciones de pago, portal, sincronización y cambio de plan sin requerir que los clientes dupliquen la lógica de orquestación de suscripciones.

Flujo central

Operaciones

Operación	Punto final	Objetivo
Listar suscripciones	GET /api/subscriptions	Recuperar suscripciones para una cuenta seleccionada con token
Lista de características	GET /api/subscriptions/features	Recuperar el conjunto de funciones de suscripción activa
Obtener identidad de suscripción	GET /api/subscriptions/identity	Recuperar el enlace de identidad de suscripción para la cuenta
Lista de comerciantes	GET /api/subscriptions/merchants	Recuperar opciones de comerciante/proveedor
Sincronizar suscripciones	POST /api/subscriptions/sync	Actualizar el estado de suscripción del proveedor
Cambiar suscripción	POST /api/subscriptions/:subscription_id/change	Modificar plan o intervalo
Cancelar suscripción	POST /api/subscriptions/:subscription_id/cancel	Finalizar el ciclo de vida de la suscripción
Crear sesión de pago	POST /api/subscriptions/stripe/checkout-session	Iniciar el proceso de pago para un plan nuevo o modificado
Crear sesión del portal	POST /api/subscriptions/stripe/portal-session	Abrir portal de suscripción de autoservicio
Sincronizar sesión de pago	POST /api/subscriptions/stripe/checkout-session-sync	Vincular la finalización del pago con el estado de la suscripción

Datos clave y estado

{
  data: {
    account_id: "acc_...",
    subscription_id: "sub_...",
    status: "active"
  },
  links: {
    checkout_url: "https://checkout.stripe.com/..."
  }
}

Todas las respuestas utilizan cargas útiles de estilo sobre proxy codificadas por data con links opcional.

Modos de falla y controles

El reclamo acc faltante o no válido rechaza las operaciones de suscripción del propietario y las personas que llaman que no son propietarios quedan bloqueadas para realizar acciones de suscripción con alcance del propietario. Los errores de proxy ascendente se devuelven como errores de operación explícitos y la mutación de la suscripción permanece restringida a cambios explícitos o cancelación de rutas.

Relacionado

Sobre de proxy de suscripción, 11-control-propietario-de-suscripción.