Métodos de pago

Los clientes recargan saldo en su billetera interna y luego compran con ese saldo. Cada recarga pasa por uno de los métodos de pago que habilites.

Los tres métodos

Entra a Configuración → Métodos de pago. Arriba verás tres pestañas:

• MercadoPago — pagos automáticos con tarjeta, PSE, Nequi, Daviplata, etc. Aprobación vía webhook.
• Bre-B — aprobación automática de transferencias bancarias con detección por correo (IMAP).
• Transferencia manual — el cliente transfiere a tu cuenta y sube un comprobante; tú lo apruebas desde el panel.

Todas las credenciales se almacenan cifradas con AES-256-GCM.

MercadoPago

La forma recomendada de conectar MercadoPago es el botón “Conectar con MercadoPago”: te lleva al login de MercadoPago (OAuth), autorizas con un clic y vuelves a Nuvlyx con la cuenta vinculada. El webhook de confirmación se registra solo, así que no tienes que copiar ni pegar nada.

Una vez conectada, la pestaña muestra el estado “Cuenta conectada” con dos acciones:

• Desconectar cuenta — desvincula MercadoPago; las recargas automáticas dejan de funcionar hasta que vuelvas a conectar.
• Reconectar con otra cuenta — repite el flujo OAuth para vincular una cuenta de MercadoPago distinta.

Configuración manual (avanzado)

Si prefieres no usar OAuth, puedes pegar las credenciales a mano. Necesitas del panel de MercadoPago:

• Access Token — empieza por APP_USR-....
• Webhook Secret — opcional pero recomendado.

En este modo aparece un webhook de confirmación; cópialo y pégalo tal cual en el panel de MercadoPago para que las aprobaciones lleguen automáticamente.

Restricciones opcionales (válidas para ambos modos): Comisión (%) y Monto mínimo. Guarda ambos botones (Guardar credenciales y Guardar restricciones).

Bre-B (aprobación automática por correo)

Bre-B no es un proveedor externo ni un SDK. Es un sistema de matching automático propio de Nuvlyx: un worker lee tu correo de Bancolombia por IMAP, detecta las transferencias entrantes y las empareja con las recargas pendientes por monto y ventana temporal. Si encuentra coincidencia única dentro del límite, la aprueba sola.

Activar y configurar

Entra a Configuración → Métodos de pago → Bre-B y activa el interruptor.

Casilla automática (recomendado)

La forma más rápida de configurar Bre-B es dejar que Nuvlyx cree la casilla de correo por ti:

• Pulsa “Generar casilla automáticamente”. Nuvlyx crea una casilla con la forma tu-tienda-breb@cod.nuvlyx.com y autocompleta los datos IMAP (email, host, puerto, contraseña) por ti.
• Pulsa “Abrir bandeja ↗” para revisar el correo de esa casilla en un webmail, sin necesidad de contraseña.
• Luego debes configurar un reenvío automático desde tu Gmail o Outlook (el correo donde Bancolombia envía las notificaciones) hacia esa casilla @cod.nuvlyx.com. La pantalla incluye dos desplegables de ayuda: “Cómo reenviar desde Gmail” y “Cómo reenviar desde Outlook”.

La configuración IMAP manual (abajo) queda como alternativa si prefieres usar tu propia casilla.

Configuración IMAP manual (alternativa)

La columna derecha pide la configuración IMAP:

• Email de la cuenta Bre-B — el correo donde Bancolombia envía las notificaciones de transferencia.
• Contraseña / token de aplicación — se guarda cifrada; déjala en blanco cuando ya esté configurada y no quieras cambiarla.
• Host IMAP — el servidor IMAP de tu proveedor de correo, por ejemplo mail.tu-dominio.com.
• Puerto IMAP — por defecto 993.
• Escaneo (min) — cada cuántos minutos consulta el buzón (por defecto 2, rango 1-60).
• Ventana match (h) — horas hacia atrás dentro de las cuales se buscan recargas pendientes para emparejar (por defecto 24, máximo 168).
• Auto-aprob. por hora — tope de aprobaciones automáticas por hora, como protección (por defecto 10, máximo 100).

¿Qué correo conviene usar?

Lo recomendable es conectar un correo de un dominio propio —por ejemplo el que ya viene con tu plan de hosting (pagos@tu-dominio.com)—. Estos buzones suelen ofrecer acceso IMAP directo y credenciales estables, sin las restricciones ni los tokens de aplicación que imponen los proveedores gratuitos.

Si no cuentas con un dominio o un hosting propio, configura en tu correo bancario un reenvío automático de los mensajes de interés (las notificaciones de transferencia de Bancolombia) hacia un buzón que el equipo de desarrolladores/administradores de Nuvlyx crea para ti. Así el worker lee ese buzón gestionado por Nuvlyx y tú solo te encargas de mantener el reenvío activo. Contacta al equipo para solicitar este buzón.

La columna izquierda define Comisión (%) y Monto mínimo (COP), igual que los otros métodos. Guárdalos con Guardar restricciones.

QR de pago

Sube una imagen del QR de tu Nequi o Bancolombia desde la app de tu banco. El storefront mostrará ese QR a cada cliente que inicie una recarga por Bre-B. El archivo se acepta en formato de imagen estándar y se asocia a la configuración del tenant.

Cómo se aprueba una recarga Bre-B

Hay tres caminos posibles:

1. Auto-match (ideal) — el worker detecta la transferencia, encuentra una única recarga pendiente con el mismo monto dentro de la ventana y la aprueba. El saldo del cliente se acredita al instante.
2. Match manual — si el monto no coincide o hay ambigüedad, la transacción llega a Operaciones → Transacciones Bre-B sin asignar. El OWNER la empareja manualmente con la recarga correcta.
3. Ignorar — si es una transferencia ajena al negocio, se marca como ignorada y no afecta a ninguna recarga.

Cada transacción registra la fecha del banco, monto, depositante, referencia bancaria y el estado. El rate-limit de auto-aprobaciones por hora evita aceptaciones masivas si algo anda mal.

Herramientas avanzadas

Las utilidades de prueba y diagnóstico de Bre-B están agrupadas en un desplegable “Herramientas avanzadas”:

• Inspector del INBOX — revisa los correos que el worker está leyendo en la casilla.
• Probar parser — pega un correo de ejemplo y verifica que Nuvlyx detecta monto, depositante y referencia.
• Sandbox — simula una transacción entrante para validar el flujo de match sin mover dinero real.
• Reset — reinicia el estado del módulo cuando necesitas empezar de cero.

Cómo ve el cliente la recarga Bre-B

En la tienda, al elegir Bre-B automático, el cliente escribe el monto (o usa un preset), opcionalmente su nombre del banco, y confirma.

Nuvlyx genera la recarga en estado pendiente y le muestra el QR que subiste, junto con el monto exacto a transferir:

El cliente escanea con Nequi y transfiere. Minutos después, cuando tu worker IMAP detecte el mensaje de Bancolombia, la recarga pasa a Aprobada automáticamente.

Transferencia manual

Es el método más simple y no requiere credenciales ni correo. Actívalo y define las cuentas bancarias en la siguiente página (Cuentas bancarias).

La transferencia manual siempre necesita tu aprobación: cada vez que un cliente sube un comprobante debes entrar a Operaciones → Recargas para revisarlo — ver aprobar recargas.