Suscripciones

Gestiona pagos recurrentes de manera flexible y segura.

Definición

En Wipay nos encargamos de brindar escalabilidad y eficiencia a los comercios que quieran integrarse con nosotros es por esto que la solución de suscripciones viene a gestionar todo el ciclo de vida de los pagos recurrentes, desde la creación hasta la finalización, incluyendo gestión de pagos, reintentos y manejo de errores. Ofrecemos una alternativa completa para modelos de negocio basados en suscripciones o para comercios que quieran implementar dicha funcionalidad para mas agilidad en los pagos recurrentes de sus clientes.

Algunos beneficios clave de la funcionalidad son:

• Proceso completo en un solo paso: Crea la suscripción y gestiona el pago inicial automáticamente

• Flexibilidad en pagos: Soporta tanto clientes con métodos de pago registrados como nuevos clientes

• Seguridad garantizada: Manejo adecuado de tokens de pago sin exponer información sensible

Casos de Uso Principales

Creación de Suscripción

Este proceso actúa como un arquitecto que construye desde cero cada suscripción recurrente. Comienza autenticando el comercio y validando sus permisos, luego configura el pago recurrente según los parámetros recibidos, establece el ciclo de facturación y, lo más crítico, gestiona el método de pago. Para clientes existentes, verifica y asocia el token de pago registrado, mientras que para nuevos clientes genera un portal seguro de registro de pago. Todo este proceso concluye con la ejecución del primer cobro y la debida activación, dejando todo listo para los proximos ciclos recurrentes.

Flujo:

1. Validación del comerciante

2. Generación de la suscripción

3. Gestión del método de pago (nuevo o existente)

4. Ejecución del primer cargo

5. Activación de la membresía

Escenarios:

• Cliente nuevo: Genera enlace seguro para registro de pago

• Cliente existente: Procesa el pago inmediatamente

Mecanismos de seguridad:

• Tokenización de datos sensibles

• Validación de permisos del comerciante

• Auditoría de todas las operaciones

---

Gestión del Primer Pago

Este componente maneja con precisión el cobro inicial, actuando como puente entre el sistema de suscripciones y la pasarela de pagos. Su importancia radica en manejar ambos posibles resultados: cuando el pago es exitoso, activa la suscripción y dispara todos los procesos asociados; cuando falla, ejecuta un protocolo de reversión completo que mantiene la integridad del sistema. Mantiene un registro detallado de cada transacción y actualiza los tokens de pago cuando es necesario, asegurando que cada suscripción comience su vida con datos financieros sólidos.

Flujo:

1. Intento de cobro con el token registrado

2. Manejo de resultados:

   • Éxito: Activa la suscripción

   • Fallo: Cancela la suscripción automáticamente

3. Actualización de estados

Escenarios:

• Reversión automática en caso de fallo

• Integración con pasarelas de pago

• Registro detallado de transacciones

---

Programación de Pagos Recurrentes

Esta funcionalidad se encarga de automatizar los cobros periódicos según la frecuencia configurada, considerando cada fecha futura de cobro y adaptándose a particularidades del calendario. Genera los registros de cargos pendientes con precisión y los programa para su ejecución diferida, integrando perfectamente con sistemas serveless que orquestan la logica de ejecución por fechas. Su visión a largo plazo le permite detectar cuándo una suscripción ha completado naturalmente su ciclo de vida, marcando adecuadamente su finalización, en conclusión este panificador es el que asegura la continuidad automática de cada suscripción.

Flujo:

1. Cálculo inteligente de fechas de cobro

2. Generación automática de cargos futuros

3. Integración con sistemas serverless para ejecución diferida

Escenarios:

• Ajuste por ciclos de facturación

• Manejo de fechas límite

• Detección de finalización de suscripción

---

Cancelación de Suscripciones

El protocolo de cierre ordenado se encarga de gestionar la finalización de cada suscripción. Este componente actúa como un administrador que registra el motivo de cada cancelación ya sea iniciada por el usuario, por fallos de pago recurrentes o por errores del sistema. Implementa políticas de limpieza para cargos futuros programados y mantiene la consistencia de datos, su actuación refleja un balance cuidadoso entre automatización y registro detallado para futuros análisis.

Flujo:

1. Actualización de estado

2. Registro de motivo

3. Limpieza de cargos programados

Escenarios:

• Por fallo del sistema: Error en procesamiento

• Por fallo del cliente: Pagos rechazados

• Manual: Iniciada por usuario/merchant

---

Manejo de Resultados de Pagos Diferidos

Este servicio procesa resultados de cobros recurrentes automáticos. Este módulo central recibe la información generada de los pagos automáticos y toma decisiones estratégicas según el resultado. Los pagos exitosos ejecutan del siguiente ciclo programado, manteniendo el flujo continuo. Los fallos del cliente activan protocolos de reintento, mientras que los errores del sistema generan acciones correctivas específicas. Actúa como medidor del sistema, ajustando continuamente el estado de cada suscripción según su información actual.

Flujo y Escenarios:

1. Recibe el resultado del pago diferido (éxito, fallo del cliente o fallo del sistema).

2. Evalúa el estado del pago y ejecuta la acción correspondiente:

   • Pago exitoso:

     • Programa automáticamente el siguiente ciclo de cobro.

     • Actualiza el estado de la suscripción y registra el pago.

   • Fallo del cliente (pago rechazado):

     • Inicia el flujo de reintentos con intervalos configurables.

     • Si se supera el máximo de intentos, cancela la suscripción.

   • Fallo del sistema (error procesamiento):

     • Cancela la suscripción por inconsistencia.

     • Registra el motivo para auditoría.

3. Actualiza registros (suscripción, historial de pagos y estado)

---

Gestión de Errores de Pago

Se encarga de manejar pagos rechazados por problemas del cliente, cuando un pago falla, este componente entra en acción con una estrategia de recuperación bien definida: implementa una secuencia de reintentos inteligentes con intervalos crecientes, monitorea el contador de intentos fallidos y, cuando se alcanza el límite máximo, ejecuta el prótocolo de cancelación. Todo este proceso está finamente ajustado mediante parámetros configurables que permiten adaptar la política de reintentos según las necesidades del negocio, manteniendo un balance entre persistencia y aceptación de la suscripción actual.

Flujo:

1. Reintentos inteligentes con backoff exponencial

2. Límite configurable de intentos

3. Cancelación automática tras máximo de fallos

Configuración:

• Número máximo de reintentos

• Intervalos entre intentos

• Acciones finales

---

Activación de Suscripciones

Funcionalidad que gestiona el inicio operativo de cada suscripción. Este proceso supervisa la transición a estado "activo", coordinando todas las actualizaciones necesarias en suscripciones, cargos y tokens. Maneja activaciones inmediatas por pagos exitosos, programaciones futuras y casos especiales como tokens generados durante el proceso de pago. Garantiza que cada cambio de estado se realice manteniendo estrictamente la consistencia transaccional, mientras dispara los eventos secundarios asociados a la activación, como notificaciones al usuario y habilitación de beneficios.

Flujo y Escenarios

1. Primer pago exitoso

2. Pago recurrente exitoso

3. Reactivación manual

• Actualización de estados

• Programación siguiente cobro

• Manejo de tokens generados

Consideraciones de Seguridad

• Todos los datos de pago se manejan mediante tokens

• Validación de identidad en cada operación

• Registro auditoría completo

• Cumplimiento PCI-DSS mediante tokenización

Esta documentación cubre los aspectos esenciales del microservicio, proporcionando una visión completa de sus capacidades y flujos de trabajo para la gestión de suscripciones recurrentes.