Introducción
El módulo Subscriptions permite configurar en el proyecto pagos regulares de los usuarios por un conjunto fijo de productos. Una suscripción consiste en un conjunto de productos y un período: cada N días, se deduce automáticamente (o manualmente) del usuario el costo, calculado como la suma de los precios de los productos incluidos.
El módulo consta de dos partes principales:
- Módulo "Subscriptions" en el menú izquierdo — catálogo de todas las suscripciones del proyecto. Aquí puedes crear, editar y eliminar suscripciones, configurar su cuenta de pago, período y composición de productos. Más detalles — en la sección de configuración de suscripciones.
- Pestaña "Subscriptions" en la tarjeta del usuario — lista de suscripciones de un usuario específico con estados, fechas de finalización y acciones manuales (para suscripciones del tipo
custom). Más detalles — en la sección de suscripciones del usuario.
El trabajo con suscripciones desde el lado de la aplicación cliente se realiza a través de la API. Más detalles — en la sección de API de suscripciones.
Cómo funciona la suscripción
Al crear una suscripción en el panel de administración, eliges:
- Cuenta de pago — determina cómo se realizará el pago. Más detalles sobre los tipos de cuentas — en la sección de cuentas de pago.
- Período en días — cada cuántos días se requiere el pago del usuario para renovar la suscripción.
- Lista de productos incluidos en la suscripción — de sus precios actuales se calcula el costo total de la suscripción.
Cuando un usuario se suscribe a través de la API, el sistema:
- Crea un registro de la suscripción para el usuario.
- Devuelve un enlace para el pago (para
stripeymidtrans) o activa inmediatamente la suscripción para el tipocustom. - Al final del período, deduce automáticamente el siguiente pago (
stripe,midtrans) o espera la renovación manual (custom).
Cuentas de pago soportadas
Se puede conectar a la suscripción uno de los siguientes tipos de cuentas de pago:
- Stripe — deducciones periódicas automáticas a través de Stripe. Después de crear la suscripción, la API devuelve un enlace para el pago inicial.
- Midtrans — deducciones periódicas automáticas a través de Midtrans. De manera similar a Stripe, devuelve un enlace para el pago.
- Custom — suscripción manual. Las deducciones no se realizan automáticamente; la renovación y cancelación son realizadas por el administrador desde la tarjeta del usuario.
El tipo de cuenta de pago determina qué acciones están disponibles sobre la suscripción y si se puede cancelar a través de la API.
Las suscripciones custom se cancelan solo a través del panel de administración — en la sección del usuario.
Dinámica de costos
El costo de la suscripción se calcula como la suma de los precios de los productos que la componen. Si cambias el precio de uno de los productos, las suscripciones activas recalcularán automáticamente su costo — el nuevo valor se aplicará a partir del siguiente período de deducción.
El período actual siempre se paga al precio que estaba vigente en el momento de su inicio. Esto permite cambiar la composición y los precios de los productos sin afectar los períodos ya pagados por el usuario.