Introducción
El módulo Subscriptions te permite configurar en el proyecto pagos periódicos de los usuarios por un conjunto fijo de productos. Una suscripción se compone de un conjunto de productos y un período: cada N días se cobra al usuario, de forma automática (o manual), un costo igual a la suma de los precios de los productos que incluye.
El módulo tiene dos partes principales:
- Módulo "Subscriptions" en el menú izquierdo: el catálogo de todas las suscripciones del proyecto. Aquí creas, editas y eliminas suscripciones, y configuras su cuenta de pago, su período y los productos que incluyen. Más información en la sección de configuración de suscripciones (se abre en una pestaña nueva).
- Pestaña "Subscriptions" en la tarjeta del usuario: la lista de suscripciones de un usuario concreto, con sus estados, fechas de finalización y acciones manuales (para suscripciones de tipo
custom). Más información en la sección de suscripciones del usuario (se abre en una pestaña nueva).
La aplicación cliente trabaja con las suscripciones a través de la API. Más información en la sección de API de suscripciones (se abre en una pestaña nueva).
Cómo funciona una suscripción
Al crear una suscripción en el panel de administración, eliges:
- Cuenta de pago: determina cómo se realiza el pago. Los tipos de cuentas se describen en la sección de cuentas de pago (se abre en una pestaña nueva).
- Período en días: cada cuántos días debe pagar el usuario para renovar la suscripción.
- Lista de productos incluidos en la suscripción: la suma de sus precios actuales da el costo total de la suscripción.
Cuando un usuario se suscribe a través de la API, el sistema:
- Crea un registro de suscripción para el usuario.
- Devuelve un enlace de pago (para
stripeymidtrans) o, en el tipocustom, activa la suscripción de inmediato. - Al terminar el período, cobra automáticamente el siguiente pago (
stripe,midtrans) o espera a que se renueve manualmente (custom).
Cuentas de pago compatibles
Puedes conectar a una suscripción una cuenta de pago de uno de estos tipos:
- Stripe: cobros periódicos automáticos a través de Stripe. Al crear la suscripción, la API devuelve un enlace para el primer pago.
- Midtrans: cobros periódicos automáticos a través de Midtrans. Igual que con Stripe, se devuelve un enlace de pago.
- Custom: suscripción manual. Los cobros no son automáticos; el administrador renueva y cancela la suscripción desde la tarjeta del usuario.
El tipo de cuenta de pago determina qué acciones están disponibles para la suscripción y si se puede cancelar a través de la API.
Las suscripciones custom se cancelan solo desde el panel de administración, en la sección del usuario.
Variación del costo
El costo de una suscripción es la suma de los precios de los productos que la componen. Si cambias el precio de uno de ellos, las suscripciones activas recalculan su costo automáticamente: el nuevo valor se aplica a partir del siguiente período de cobro.
El período en curso siempre se paga al precio vigente en el momento en que comenzó. Así puedes cambiar los productos y sus precios sin afectar los períodos que el usuario ya pagó.