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.