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 por servicios, pagos únicos y cargos recurrentes sin almacenar datos sensibles de tarjetas en OmniCRM.

Véase también: Guía del Sistema de Pagos, Resumen de Facturación, Procesamiento de Pagos, Facturas.

Descripció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 Multivendor - 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 Portal de Autoservicio
• 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 forma 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 del método de pago específico del proveedor

Accediendo a Métodos de Pago

Desde la Página del Cliente:

1. Navegar a Clientes → [Seleccionar Cliente]
2. Hacer clic en la pestaña Facturación
3. Desplazarse 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 - Remover la tarjeta de la cuenta

Agregando un Método de Pago

Haga 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 haga 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)
   • El token se devuelve 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, la marca, el vencimiento y el 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:

Su Visa que termina en 1234 ha sido agregada a su cuenta.

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

Selección Predeterminada Automática:

• 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 por servicios
• Pagos de facturas
• Recargas y recargas
• Transacciones únicas (a menos que se especifique lo contrario)

Para Cambiar el Predeterminado:

1. Localice la tarjeta que desea establecer como predeterminada en la tabla de métodos de pago

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

3. Seleccione "Establecer como Predeterminado"

4. Aparece la confirmación

   La Visa que termina en 5678 ahora es su método de pago predeterminado.

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

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

Eliminar tarjetas que están vencidas, perdidas o que ya no se necesitan.

Paso 1: Iniciar Eliminación

1. Encuentre la tarjeta a eliminar en la tabla de métodos de pago
2. Haga clic en el ícono de papelera en esa fila

Si el cliente tiene solo un método de pago activo, el ícono de papelera está deshabilitado. Al pasar el cursor sobre él, se muestra un tooltip:

No se puede eliminar su único método de pago. Agregue otro método de pago primero.

Agregue un segundo método de pago antes de poder eliminar el existente.

Paso 2: Confirmar Eliminación

Cuando se permite la eliminación, aparece un modal de confirmación:

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

[Cancelar] [Eliminar Método de Pago]

Si el método que se está eliminando es el predeterminado actual y existen otros métodos activos, el modal indica que otro método activo será promovido a predeterminado después de la eliminación.

Haga 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 elimina del proveedor de pago.

Restricciones Importantes:

• No se puede eliminar el único método de pago activo - El control de eliminación está deshabilitado (con tooltip). La API también rechaza la solicitud. Agregue otro método de pago primero.
• Eliminar el predeterminado cuando existen otros - Otro método de pago activo utilizable se promueve automáticamente a predeterminado.
• Sin deshacer - La eliminación es permanente; el cliente debe volver a agregar el método si es necesario.

Gestión de 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

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

Cliente Tarjeta 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 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 Autoservicio

Consulte 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 (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

aviso

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

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

Qué Ocurre 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 cargar 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 un 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 agote 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)
• Se envía un correo electrónico de advertencia
• 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 Interrupciones del Servicio:

Para evitar interrupciones del servicio:

• Actualice las tarjetas 30 días antes del vencimiento
• Agregue múltiples métodos de pago para redundancia
• Habilite alertas de fallo de pago
• Monitoree 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. Agregue un nuevo método de pago válido
2. Establezca como predeterminado
3. Pague el saldo pendiente (si lo hay)
4. Contacte al soporte para reactivar el servicio
5. El servicio se restaura 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 usar 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 a través de HTTPS/TLS

Consulte Guía del Sistema de Pagos para detalles de seguridad del proveedor de pagos.

Flujos de Trabajo Comunes

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

Escenario: Nuevo cliente registrándose 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 compra
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. Se provisiona el servicio
8. Se procesa el primer cargo

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 en 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. El personal: "Su tarjeta ha vencido. ¿Tiene una nueva tarjeta?"
5. El cliente proporciona los detalles de la nueva 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 terminando en 1111)
2. La establece como predeterminada para cargos mensuales por servicios
3. Agrega una tarjeta de respaldo (Mastercard terminando en 2222) para recargas
4. Agrega una tarjeta de compra (Amex terminando en 3333) para compras de equipos
5. Al hacer una recarga, selecciona Mastercard manualmente en el proceso de compra
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 (Admin)

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 una semana después
8. Llama a los clientes restantes que no han actualizado
9. Ayuda 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:
  • Intente con una tarjeta diferente
  • Contacte al emisor de la tarjeta para autorizar la transacción
  • Asegúrese de que la tarjeta soporte compras en línea
  • Verifique que la dirección de facturación coincida con la tarjeta registrada

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

• Causa: Error en la API del proveedor de pago o problema de red
• Solución:
  • Actualice la página e intente nuevamente
  • Verifique la conexión a Internet
  • Verifique que la configuración del proveedor de pago sea correcta en la configuración del sistema
  • Revise la consola del navegador para un mensaje de error específico
  • Pruebe con un navegador diferente (desactive los bloqueadores de anuncios)

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

• Causa: Es el único método de pago activo del cliente
• Solución:
  • Agregue un nuevo método de pago primero, luego elimine el antiguo
  • Pase el cursor sobre el ícono de papelera deshabilitado para la explicación del tooltip

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

• Causa: La tarjeta venció recientemente, la caché no se actualizó
• Solución:
  • Actualice la página
  • Verifique 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, actualice manualmente el navegador
  • Verifique 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:
  • Verifique la consola del navegador en busca de errores
  • Desactive los bloqueadores de anuncios y la protección de seguimiento
  • Verifique la configuración del proveedor de pago en la configuración del sistema
  • Asegúrese de que el script del SDK del proveedor se cargue (verifique la pestaña de Red)
  • Pruebe en modo incógnito/navegación privada

El cliente no recibe notificaciones de vencimiento

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

Mejores Prácticas

Para Clientes:

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

Para el Personal de Soporte:

• Verifique la identidad del cliente antes de acceder a los métodos de pago
• Nunca pida a los clientes que envíen detalles de la tarjeta por correo electrónico/SMS/chat
• Procese las adiciones de tarjetas de inmediato durante las llamadas (no posponga)
• Confirme que la nueva tarjeta esté establecida como predeterminada después de agregar
• Elimine las tarjetas antiguas solo después de confirmar que la nueva tarjeta funciona
• Pruebe el pago después de actualizar la tarjeta vencida (procese una autorización de £0.01)

Para Administradores:

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

Documentación Relacionada

• Guía del Sistema de Pagos - Referencia completa de la API de pagos y 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