Gestión de Métodos de Pago

El sistema de Métodos de Pago de OmniCRM permite a los clientes y al personal gestionar de manera segura las tarjetas de pago utilizando procesamiento de pagos de múltiples proveedores (Stripe, PayPal, etc.). Los métodos de pago permiten la facturación automática de servicios, pagos únicos y cargos recurrentes sin almacenar datos sensibles de tarjetas en OmniCRM.

Consulta también: Payment Vendor Integrations <integrations_payment_vendors>, Payment Processing Architecture <payment_processing_architecture>, Billing Overview <billing_overview>, Payment Processing <payments_process>, Invoices <payments_invoices>.

Visión General

El sistema de métodos de pago proporciona:

• Almacenamiento Seguro de Tarjetas - Tarjetas tokenizadas por proveedores de pago (Stripe, PayPal), nunca almacenadas en OmniCRM
• Soporte Multi-Proveedor - Métodos de pago de Stripe y PayPal soportados
• Múltiples Tarjetas - Los clientes pueden almacenar múltiples métodos de pago
• Selección Predeterminada - Designar el método de pago preferido para cargos automáticos
• Seguimiento de Vencimientos - Monitorear y actualizar tarjetas que están por vencer
• Autoservicio - Los clientes pueden gestionar sus propias tarjetas a través del Self-Care Portal <self_care_portal>
• Gestión del Personal - El personal de soporte puede agregar/eliminar tarjetas en nombre de los clientes

Métodos de Pago Soportados:

• Tarjetas (a través de Stripe o PayPal)
  • Tarjetas de Crédito (Visa, Mastercard, American Express, Discover)
  • Tarjetas de Débito
  • Tarjetas Prepagadas (si son soportadas por la red de tarjetas)
• Cuentas de PayPal (a través de la integración de PayPal)

No Almacenado en OmniCRM:

Los detalles de la tarjeta son tokenizados por los proveedores de pago y almacenados de manera segura. OmniCRM solo almacena:

• Proveedor de pago (stripe, paypal)
• Marca de la tarjeta (Visa, Mastercard, etc.)
• Últimos 4 dígitos
• Mes/año de vencimiento
• Nombre/apodo del titular de la tarjeta
• Token de método de pago específico del proveedor

Accediendo a Métodos de Pago

Desde la Página del Cliente:

1. Navega a Clientes → [Seleccionar Cliente]
2. Haz clic en la pestaña Facturación
3. Desplázate a la sección Métodos de Pago

O directamente:

Desde el Tablero de Tarjetas que Vencen:

Ver todos los clientes con tarjetas que están por vencer:

Esto muestra una lista a nivel de sistema de tarjetas que vencen dentro de los próximos 60 días.

Lista de Métodos de Pago

La tabla de métodos de pago muestra todas las tarjetas almacenadas para un cliente:

Descripciones de Columnas:

• Apodo - Nombre amigable para la tarjeta (por ejemplo, "Tarjeta Personal", "Visa de Trabajo")
• Emisor - Marca de la tarjeta y últimos 4 dígitos
• Vencimiento - Mes/año de vencimiento (formato MM/YYYY)
• Agregado - Fecha en que se agregó la tarjeta a la cuenta
• Predeterminado - Marca de verificación indica el método de pago predeterminado para cargos automáticos

Acciones por Tarjeta:

Cada fila tiene un menú de acciones (⋮) con opciones:

• Establecer como Predeterminado - Hacer de este el método de pago predeterminado
• Eliminar - Eliminar la tarjeta de la cuenta

Agregando un Método de Pago

Haz clic en "Agregar Método de Pago" para abrir el modal de pago seguro.

Paso 1: Ingresar Detalles de la Tarjeta

El formulario de pago seguro aparece (potenciado por Stripe Elements o PayPal SDK):

Campos Requeridos:

• Informaci��n de la Tarjeta - Número de tarjeta, vencimiento, CVC (validado por Stripe)
• Nombre del Titular de la Tarjeta - Nombre en la tarjeta
• País/Región - País de facturación

Campos Opcionales:

• Apodo de la Tarjeta - Etiqueta amigable para distinguir entre tarjetas

Seguridad:

• Los detalles de la tarjeta se ingresan directamente en un iframe seguro alojado por el proveedor (Stripe Elements / PayPal SDK)
• OmniCRM nunca ve ni almacena números de tarjeta completos
• Cumplimiento de PCI DSS manejado por el proveedor de pago
• La validación en tiempo real previene números de tarjeta inválidos

Paso 2: Enviar y Tokenizar

Cuando haces clic en "Agregar Método de Pago":

1. Validación del Lado del Cliente:
   • El proveedor de pago valida el formato del número de tarjeta
   • Verifica que la fecha de vencimiento esté en el futuro
   • Verifica el formato del CVC
2. Tokenización:
   • Los detalles de la tarjeta se envían directamente al proveedor de pago (no a OmniCRM)
   • El proveedor crea un token seguro (por ejemplo, pm_1A2B3C4D para Stripe)
   • Token devuelto a OmniCRM
3. Procesamiento del Servidor:
   • OmniCRM guarda el token en el registro del cliente con el identificador del proveedor
   • Almacena los últimos 4 dígitos, marca, vencimiento y nombre del proveedor para mostrar
   • Ningún número de tarjeta completo toca los servidores de OmniCRM

Paso 3: Confirmación

Aparece un mensaje de éxito:

Tu Visa terminada en 1234 ha sido agregada a tu cuenta.

La nueva tarjeta aparece en la tabla de métodos de pago.

Selección Automática Predeterminada:

• Si esta es la primera tarjeta del cliente, se establece automáticamente como predeterminada
• Si el cliente ya tiene tarjetas, la nueva tarjeta se agrega como no predeterminada
• El cliente puede cambiar la predeterminada después de agregar

Estableciendo el Método de Pago Predeterminado

El método de pago predeterminado se utiliza para:

• Cargos automáticos recurrentes de servicios
• Pagos de facturas
• Recargas y recargas
• Transacciones únicas (a menos que se especifique lo contrario)

Para Cambiar el Predeterminado:

1. Localiza la tarjeta que deseas establecer como predeterminada en la tabla de métodos de pago

2. Haz clic en el menú de acciones (⋮) junto a la tarjeta

3. Selecciona "Establecer como Predeterminado"

4. Aparece la confirmación

   Visa terminada en 5678 ahora es tu método de pago predeterminado.

La marca de verificación se mueve a la tarjeta seleccionada recientemente.

Indicador Visual:

Las tarjetas predeterminadas muestran:

en la columna Predeterminado, típicamente con una insignia de marca de verificación verde.

Eliminando un Método de Pago

Elimina tarjetas que están vencidas, perdidas o que ya no son necesarias.

Paso 1: Iniciar la Eliminación

1. Encuentra la tarjeta a eliminar en la tabla de métodos de pago
2. Haz clic en el menú de acciones (⋮)
3. Selecciona "Eliminar"

Paso 2: Confirmar la Eliminación

Aparece un modal de confirmación:

¿Estás seguro de que deseas eliminar este método de pago?

Tarjeta: Visa terminada en 1234 Vencimiento: 12/2026

⚠️ Advertencia: Si este es tu único método de pago, necesitarás agregar uno nuevo para continuar utilizando los servicios que requieren facturación automática.

[Cancelar] [Eliminar Método de Pago]

Haz clic en "Eliminar Método de Pago" para confirmar.

Paso 3: Eliminación Completa

Mensaje de éxito:

La tarjeta se elimina de la tabla y se borra del proveedor de pago.

Restricciones Importantes:

• No se puede eliminar el predeterminado si existen otras tarjetas - Establece una tarjeta diferente como predeterminada primero
• Advertencia si se elimina la última tarjeta - Los servicios que requieren pago pueden ser suspendidos
• Sin deshacer - La eliminación es permanente; el cliente debe volver a agregar la tarjeta si es necesario

Gestionando Tarjetas que Vencen

OmniCRM rastrea las fechas de vencimiento de las tarjetas y proporciona herramientas para actualizar proactivamente las tarjetas que están por vencer.

Tablero de Tarjetas que Vencen

Navega a Facturación → Tarjetas que Vencen para ver una lista a nivel de sistema:

Cliente Tarjeta Vencimiento Días Hasta la Acción John Smith Visa **1234 02/2025 12 días Actualizar Acme Corp MC5678 03/2025 45 días Actualizar Jane Doe Amex**9012 01/2025 VENCIDA Actualizar

Filtros:

• Rango de Vencimiento - Próximos 30/60/90 días o ya vencidos
• Tipo de Cliente - Individual vs Empresa
• Tipo de Servicio - Filtrar por servicio que requiere método de pago

Acciones:

• Actualizar - Abre la página de métodos de pago del cliente para agregar una nueva tarjeta
• Notificar - Enviar recordatorio por correo electrónico al cliente (si Mailjet está configurado)

Notificaciones de Vencimiento

Si Mailjet está configurado, se envían correos electrónicos automáticos:

• 60 días antes del vencimiento - Primer recordatorio
• 30 días antes del vencimiento - Segundo recordatorio
• 7 días antes del vencimiento - Advertencia final
• Al vencimiento - Aviso de que la tarjeta ha vencido

Los clientes pueden hacer clic en un enlace en el correo electrónico para actualizar su método de pago a través del portal de autoservicio.

Variables de Plantilla de Correo Electrónico:

Las plantillas de Mailjet reciben:

• Nombre del cliente
• Marca de la tarjeta y últimos 4 dígitos
• Fecha de vencimiento
• Enlace a la página de métodos de pago del Self-Care

Consulta integrations_mailjet para la configuración de la plantilla de correo electrónico.

Actualizando una Tarjeta que Vence

Flujo de Trabajo Recomendado:

1. El cliente recibe un correo electrónico de notificación de vencimiento
2. El cliente inicia sesión en el portal de autoservicio
3. Navega a Facturación → Métodos de Pago
4. Hace clic en "Agregar Método de Pago"
5. Ingresa los detalles de la nueva tarjeta (la misma tarjeta con vencimiento actualizado, o tarjeta de reemplazo)
6. Establece la nueva tarjeta como predeterminada
7. Elimina la tarjeta antigua/vencida

Flujo de Trabajo del Personal:

Si el cliente llama al soporte:

1. El personal abre la cuenta del cliente
2. Navega a Facturación → Métodos de Pago
3. Agrega una nueva tarjeta en nombre del cliente (el cliente proporciona detalles por teléfono)
4. Establece la nueva tarjeta como predeterminada
5. Elimina la tarjeta vencida
6. Confirma con el cliente

Advertencia

Nunca pidas a los clientes que envíen detalles de la tarjeta por correo electrónico o mensaje de texto. Siempre usa:

• Portal de autoservicio seguro para autoservicio
• Teléfono con el personal ingresando detalles directamente en el sistema
• En persona en la ubicación minorista

Qué Sucede Cuando las Tarjetas Vencen

Cuando una tarjeta de pago alcanza su fecha de vencimiento y no se actualiza:

Efectos Inmediatos:

1. Los Pagos Automáticos Fallan
   • El proveedor de pago rechaza transacciones con tarjetas vencidas
   • Las renovaciones de servicios mensuales no se procesan
   • Las recargas automáticas fallan
   • Los pagos automáticos de facturas fallan
2. Notificaciones al Cliente
   • El sistema intenta cobrar a la tarjeta
   • Se envía una notificación de fallo de pago
   • Se envía un correo electrónico "Actualizar Método de Pago" con enlace al portal de autoservicio
3. Cambios en el Estado del Servicio
   • Servicios Postpago - Pueden continuar temporalmente con saldo pendiente
   • Servicios Prepago - Suspensión del servicio cuando se agota el saldo
   • Servicios de Renovación Automática - La renovación falla, el servicio puede expirar

Acciones Subsiguientes:

Día 1-3 (Período de Gracia):

• El servicio continúa normalmente
• El cliente recibe el primer aviso de fallo de pago
• El sistema intenta reintentar (dependiendo de la configuración)

Día 4-7:

• Segundo intento de pago (si está configurado)
• Correo electrónico de advertencia enviado
• El servicio al cliente puede contactar al cliente

Día 8-14:

• El servicio puede ser suspendido por falta de pago
• El estado suspendido previene el uso pero preserva la cuenta
• El cliente puede restaurar actualizando el método de pago y pagando el saldo pendiente

Día 15+:

• El servicio puede ser terminado por falta de pago
• Inventario (tarjetas SIM, equipos) marcado para devolución
• Se envía un aviso final
• La cuenta se refiere a cobranzas (si corresponde)

Previniendo la Interrupción del Servicio:

Para evitar la interrupción del servicio:

• Actualiza las tarjetas 30 días antes del vencimiento
• Agrega múltiples métodos de pago para redundancia
• Habilita alertas de fallo de pago
• Monitorea el tablero de Tarjetas que Vencen semanalmente

Restaurando el Servicio Después del Vencimiento:

Si el servicio se suspendió debido a una tarjeta vencida:

1. Agrega un nuevo método de pago válido
2. Establece como predeterminado
3. Paga el saldo pendiente (si lo hay)
4. Contacta al soporte para reactivar el servicio
5. Servicio restaurado en minutos a horas

Seguridad del Método de Pago

Tokenización

OmniCRM utiliza la tokenización del proveedor para garantizar la seguridad:

1. El cliente ingresa la tarjeta → Enviada directamente a los servidores del proveedor de pago
2. El proveedor valida y tokeniza → Crea un token único
3. Token almacenado en OmniCRM → El número completo de la tarjeta nunca se almacena
4. Procesamiento de pagos → Token enviado al proveedor, el proveedor carga la tarjeta

Lo que OmniCRM Almacena:

{
  "vendor": "stripe",
  "vendor_payment_method_id": "pm_1A2B3C4D5E6F",
  "payment_type": "card",
  "brand": "visa",
  "last4": "1234",
  "exp_month": 12,
  "exp_year": 2026,
  "name": "John Smith",
  "nickname": "Personal Card",
  "is_default": true
}

Lo que OmniCRM NO Almacena:

• Número completo de la tarjeta
• Código CVV/CVC
• Datos de la banda magnética
• Números PIN

Cumplimiento de PCI

Al utilizar formularios de pago alojados por el proveedor:

• Alcance PCI reducido - Los datos de la tarjeta nunca tocan los servidores de OmniCRM
• Campos alojados por el proveedor - La entrada de la tarjeta ocurre en el iframe seguro del proveedor
• Sin almacenamiento de tarjetas - Se utilizan tokens en lugar de datos de tarjeta en bruto
• Transmisión segura - Toda la comunicación se realiza a través de HTTPS/TLS

Consulta Payment Vendor Integrations <integrations_payment_vendors> para detalles de seguridad específicos del proveedor.

Flujos de Trabajo Comunes

Flujo de Trabajo 1: El Cliente Agrega el Primer Método de Pago

Escenario: Nuevo cliente que se registra para el servicio

1. El cliente crea una cuenta
2. Selecciona un plan de servicio
3. Se le solicita agregar un método de pago durante el proceso de pago
4. Ingresa los detalles de la tarjeta en el modal de Stripe
5. La tarjeta es tokenizada y guardada
6. Se establece automáticamente como predeterminada
7. Servicio provisionado
8. Primer cargo procesado

Flujo de Trabajo 2: El Cliente Actualiza una Tarjeta que Vence

Escenario: Tarjeta de crédito a punto de vencer

1. El cliente recibe una notificación por correo electrónico (60 días antes del vencimiento)
2. Inicia sesión en el portal de autoservicio
3. Navega a Facturación → Métodos de Pago
4. Revisa la tarjeta actual que vence 12/2025
5. Hace clic en "Agregar Método de Pago"
6. Ingresa la tarjeta de reemplazo con vencimiento 12/2028
7. Establece la nueva tarjeta como predeterminada
8. Elimina la tarjeta antigua
9. Se envía un correo electrónico de confirmación

Flujo de Trabajo 3: El Personal Ayuda al Cliente por Teléfono

Escenario: El cliente llama: "Mi tarjeta fue rechazada"

1. El cliente llama al soporte
2. El personal verifica la identidad (preguntas de seguridad)
3. El personal revisa los métodos de pago: Tarjeta vencida 01/2025
4. Personal: "Tu tarjeta ha vencido. ¿Tienes una nueva tarjeta?"
5. El cliente proporciona los nuevos detalles de la tarjeta por teléfono
6. El personal navega a Clientes → [Cliente] → Facturación
7. Hace clic en "Agregar Método de Pago"
8. Ingresa los detalles de la tarjeta mientras el cliente los lee
9. Establece la nueva tarjeta como predeterminada
10. Elimina la tarjeta vencida
11. Reintenta el pago fallido
12. Confirma con el cliente: "Pago exitoso, servicio restaurado"

Flujo de Trabajo 4: Cliente Empresarial con Múltiples Tarjetas

Escenario: La empresa quiere diferentes tarjetas para diferentes propósitos

1. El cliente empresarial agrega la tarjeta principal (Visa terminada en 1111)
2. Se establece como predeterminada para cargos de servicio mensuales
3. Agrega una tarjeta de respaldo (Mastercard terminada en 2222) para recargas
4. Agrega una tarjeta de compra (Amex terminada en 3333) para compras de equipos
5. Al hacer una recarga, selecciona Mastercard manualmente en el proceso de pago
6. La Visa predeterminada aún se utiliza para la facturación automática mensual

Flujo de Trabajo 5: Gestión de Tarjetas que Vencen (Administrador)

Escenario: Gestión proactiva de vencimientos

1. El administrador navega a Facturación → Tarjetas que Vencen
2. Filtros: "Próximos 30 días"
3. Ve 15 clientes con tarjetas que están por vencer
4. Selecciona todos → "Enviar Correos Electrónicos de Recordatorio"
5. Mailjet envía correos electrónicos personalizados a cada cliente
6. Los clientes actualizan tarjetas a través del autoservicio
7. El administrador revisa la lista 1 semana después
8. Llama a los clientes restantes que no han actualizado
9. Asiste con las actualizaciones de tarjetas por teléfono

Solución de Problemas

"Tarjeta rechazada" al agregar método de pago

• Causa: El proveedor de pago rechazó la tarjeta (fondos insuficientes, prevención de fraude, rechazo del emisor)
• Solución:
  • Prueba con una tarjeta diferente
  • Contacta al emisor de la tarjeta para autorizar la transacción
  • Asegúrate de que la tarjeta soporte compras en línea
  • Verifica que la dirección de facturación coincida con la tarjeta registrada

"Error al agregar método de pago" (error genérico)

• Causa: Error de API del proveedor de pago o problema de red
• Solución:
  • Actualiza la página y vuelve a intentarlo
  • Verifica la conexión a Internet
  • Verifica que la configuración del proveedor de pago sea correcta en la configuración del sistema
  • Revisa la consola del navegador para un mensaje de error específico
  • Prueba con un navegador diferente (desactiva bloqueadores de anuncios)

No se puede eliminar el método de pago (botón deshabilitado)

• Causa: Intentando eliminar la tarjeta predeterminada, o es la única tarjeta
• Solución:
  • Establece una tarjeta diferente como predeterminada primero
  • Si es la única tarjeta, agrega una nueva tarjeta antes de eliminar

La tarjeta aparece como vencida pero no en la lista de "Tarjetas que Vencen"

• Causa: La tarjeta venció recientemente, caché no actualizado
• Solución:
  • Actualiza la página
  • Verifica los filtros en el tablero de Tarjetas que Vencen
  • Las tarjetas vencidas pueden moverse a una vista diferente

Nueva tarjeta no aparece inmediatamente

• Causa: La página no se ha actualizado después de agregar la tarjeta
• Solución:
  • La tabla de métodos de pago debería actualizarse automáticamente
  • Si no, actualiza manualmente el navegador
  • Verifica si ocurrió un error durante el proceso de adición

El modal de pago no se carga

• Causa: SDK del proveedor de pago no se carga, problema con la clave API, o extensión del navegador bloqueando
• Solución:
  • Revisa la consola del navegador para errores
  • Desactiva bloqueadores de anuncios y protección de seguimiento
  • Verifica la configuración del proveedor de pago en la configuración del sistema
  • Asegúrate de que el script del SDK del proveedor se cargue (verifica la pestaña de Red)
  • Prueba en modo incógnito/navegación privada

El cliente no recibe notificaciones de vencimiento

• Causa: Mailjet no configurado o plantilla de correo electrónico faltante
• Solución:
  • Verifica las credenciales de Mailjet en crm_config.yaml
  • Verifica que exista una plantilla de correo electrónico para el vencimiento de la tarjeta
  • Confirma que la dirección de correo electrónico del cliente sea válida
  • Revisa los registros de Mailjet para fallos de entrega

Mejores Prácticas

Para Clientes:

• Agrega un método de pago antes de la activación del servicio para evitar retrasos
• Mantén al menos 2 tarjetas registradas para redundancia
• Actualiza tarjetas que están por vencer 30+ días antes del vencimiento
• Elimina tarjetas antiguas/vencidas para evitar confusiones
• Usa apodos descriptivos ("Visa Personal", "Amex de Trabajo")
• Verifica que el método de pago predeterminado sea correcto para la facturación automática

Para el Personal de Soporte:

• Verifica la identidad del cliente antes de acceder a los métodos de pago
• Nunca pidas a los clientes que envíen detalles de la tarjeta por correo electrónico/SMS/chat
• Procesa las adiciones de tarjetas inmediatamente durante las llamadas (no las pospongas)
• Confirma que la nueva tarjeta esté establecida como predeterminada después de agregar
• Elimina las tarjetas antiguas solo después de confirmar que la nueva tarjeta funciona
• Prueba el pago después de actualizar la tarjeta vencida (procesa una autorización de £0.01)

Para Administradores:

• Monitorea el tablero de Tarjetas que Vencen semanalmente
• Envía correos electrónicos de recordatorio 60/30/7 días antes del vencimiento
• Mantén las claves de prueba/vivo del proveedor de pago separadas para desarrollo vs producción
• Asegúrate de que las plantillas de Mailjet estén configuradas para notificaciones de vencimiento
• Revisa los informes de pagos fallidos para identificar tarjetas vencidas
• Capacita al personal sobre procedimientos seguros para el manejo de tarjetas

Mejores Prácticas de Seguridad:

• Solo usa claves públicas/publicables en el frontend (nunca claves secretas)
• Asegúrate de que todas las páginas de pago se carguen a través de HTTPS
• Revisa regularmente los paneles de proveedores de pago para detectar actividad sospechosa
• Habilita reglas de prevención de fraude del proveedor (Stripe Radar, verificaciones de riesgo de PayPal)
• Requiere CVC para todas las transacciones sin tarjeta presente
• Registra cambios en los métodos de pago en el registro de actividad

Documentación Relacionada

• Payment Vendor Integrations <integrations_payment_vendors> - Configuración de pago multi-proveedor
• Payment Processing Architecture <payment_processing_architecture> - Detalles completos de la arquitectura
• payments_process - Procesamiento de pagos con métodos de pago almacenados
• payments_invoices - Pago automático de facturas utilizando la tarjeta predeterminada
• features_topup_recharge - Sistema de recarga utilizando métodos de pago
• basics_payment - Conceptos generales de pago y facturación
• customer_care - Portal de autoservicio para que los clientes gestionen sus propias tarjetas