Pagos Recurrentes Automáticos

1. ¿Qué son los Pagos Recurrentes?

Los pagos recurrentes permiten automatizar la generación de pagos periódicos para contratos activos. En lugar de crear cada pago manualmente, defines un "schedule" (programación) y el sistema genera los pagos automáticamente según la frecuencia configurada.

Ventajas:

• Ahorro de tiempo: No necesitas crear cada pago manualmente
• Reducción de errores: El sistema calcula fechas y montos automáticamente
• Automatización completa: Puede enviar links de pago y procesar cargos SEPA automáticamente

2. Crear un Schedule de Pago Recurrente

Acceso:

1. Ve a Pagos → Pagos Recurrentes
2. Haz clic en "Crear Pago Recurrente"

Configuración Básica:

2.1. Seleccionar Contrato:

• Elige el contrato para el cual crear el schedule
• Solo se muestran contratos activos

2.2. Frecuencia de Pago:

• Diario (DAILY): Genera un pago cada día
• Semanal (WEEKLY): Genera un pago cada semana
• Quincenal (BIWEEKLY): Genera un pago cada 15 días
• Mensual (MONTHLY): Genera un pago cada mes (más común)
• Trimestral (QUARTERLY): Genera un pago cada 3 meses
• Anual (YEARLY): Genera un pago cada año

2.3. Día de Facturación:

• Selecciona el día del mes en que se generará el pago
• Ejemplo: Si seleccionas día 5, el pago se generará el día 5 de cada mes

2.4. Fecha de Inicio:

• Define cuándo comenzará a generar pagos
• El primer pago se generará en esta fecha

2.5. Fecha de Fin (Opcional):

• Si defines una fecha de fin, el schedule dejará de generar pagos después de esa fecha
• Si no defines fecha de fin, el schedule continuará indefinidamente hasta que lo desactives

2.6. Número de Pagos (Opcional):

• Alternativa a fecha de fin
• Define cuántos pagos generar en total
• Ejemplo: Si configuras 12 pagos mensuales, generará 12 pagos y luego se detendrá

3. Método de Pago Recurrente

Debes seleccionar cómo se procesará cada pago generado:

3.1. Pendiente de Asignar (PENDING):

• El pago se crea pero no se procesa automáticamente
• Requiere consolidación bancaria manual
• Útil cuando recibes pagos por transferencia o efectivo

3.2. SEPA Direct Debit:

• Cobro automático mediante domiciliación bancaria
• Requiere que el cliente tenga un mandato SEPA activo
• El sistema carga automáticamente desde la cuenta bancaria del cliente
• Requisitos: IBAN del cliente y mandato SEPA configurado

3.3. Payment Link:

• Genera un link de pago automáticamente
• Envía el link por email al cliente (si está activado)
• El cliente paga con tarjeta cuando recibe el link
• Requisitos: Email del cliente y Stripe/Redsys configurado

3.4. Bank API (Próximamente):

• Integración directa con APIs bancarias
• No disponible todavía

4. Configuración Avanzada

4.1. Envío Automático de Links:

• Si seleccionaste Payment Link como método
• Activa "Enviar link automáticamente" para que el sistema envíe el link por email al cliente cuando se genere el pago
• Requisito: El cliente debe tener email configurado

4.2. Recordatorios:

• Activa "Enviar recordatorio" para recordar al cliente antes del vencimiento
• Configura "Días antes" para definir cuándo enviar el recordatorio
• Funciona igual que los recordatorios de pagos manuales

4.3. Crear Pagos Antes:

• Por defecto: 0 días (el pago se crea el mismo día del vencimiento)
• Puedes configurar días antes para crear el pago con anticipación
• Ejemplo: Si configuras 3 días antes, el pago se creará 3 días antes de la fecha de facturación

4.4. Monto del Pago:

• Por defecto, usa el precio mensual del contrato
• Puedes personalizar el monto si es diferente

4.5. Notas:

• Campo de texto libre para anotaciones sobre el schedule
• Útil para recordar detalles específicos de este schedule

5. Generación Automática de Pagos

Proceso:

• El sistema ejecuta un cron job diario a las 8:00 AM UTC
• Busca schedules activos cuya fecha de próximo pago sea hoy o anterior
• Para cada schedule encontrado:

1. Genera un nuevo pago con los datos configurados
2. Calcula la siguiente fecha de pago según la frecuencia
3. Actualiza la fecha del próximo pago del schedule
4. Si el envío automático de links está activo, envía el link por email
5. Si el método es SEPA, programa el cargo para la fecha correspondiente

Ejemplo:

• Schedule mensual con día de facturación: 5
• Fecha de inicio: 5 de enero
• El sistema generará pagos el: 5 de enero, 5 de febrero, 5 de marzo, etc.

6. Procesar Cargos SEPA Automáticamente

Si configuraste SEPA Direct Debit como método:

Proceso:

• El sistema ejecuta un cron job diario a las 10:00 AM UTC
• Busca pagos recurrentes con método SEPA cuya fecha de cargo sea hoy o anterior
• Para cada pago encontrado:

1. Ejecuta el cargo usando Stripe Payment Intent
2. Actualiza el estado del pago según el resultado:

• PAID: Si el cargo fue exitoso
• FAILED: Si el cargo fue rechazado

1. Envía notificación al cliente

Estados del Mandato SEPA:

• PENDING: Mandato creado pero no confirmado por el cliente
• ACTIVE: Mandato activo, se pueden procesar cargos
• INACTIVE: Mandato cancelado o expirado

7. Gestionar Schedules

Activar/Desactivar:

• Puedes activar o desactivar un schedule sin eliminarlo
• Un schedule desactivado no generará más pagos hasta que lo reactives

Editar:

• Abre el schedule desde la lista
• Haz clic en "Editar"
• Modifica la configuración necesaria
• Guarda los cambios

Eliminar:

• Haz clic en "Eliminar"
• Confirma la eliminación
• Advertencia: Esto no elimina los pagos ya generados, solo el schedule

Generar Pago de Prueba:

• Puedes generar un pago de prueba manualmente para verificar que todo funciona
• Útil para probar antes de activar el schedule

8. Estadísticas de Pagos Recurrentes

En la página de Pagos Recurrentes verás:

• Total de schedules: Cantidad total de schedules creados
• Schedules activos: Cantidad de schedules que están generando pagos
• Pagos generados: Total de pagos generados por schedules
• Pagos pagados: Cantidad de pagos generados que ya fueron pagados

9. Casos de Uso Comunes

Caso 1: Alquiler Mensual con Link de Pago

• Frecuencia: Mensual
• Día: 1 de cada mes
• Método: Payment Link
• Envío automático: Activado
• El cliente recibe el link cada mes y paga con tarjeta

Caso 2: Alquiler Mensual con Domiciliación SEPA

• Frecuencia: Mensual
• Día: 5 de cada mes
• Método: SEPA Direct Debit
• El sistema carga automáticamente desde la cuenta del cliente

Caso 3: Pago Trimestral con Consolidación Manual

• Frecuencia: Trimestral
• Método: Pendiente de asignar
• El sistema genera el pago pero tú lo marcas como pagado cuando recibes la transferencia

Próximos Pasos

• Configura SEPA Direct Debit para habilitar cargos automáticos
• Revisa los pagos generados periódicamente para verificar que todo funciona correctamente
• Combina con recordatorios automáticos para maximizar la tasa de cobro

> Tip: Los pagos recurrentes son ideales para contratos de largo plazo. Configura el método de pago según las preferencias de tus clientes: SEPA para automatización completa, Payment Link para flexibilidad.