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 Sistema → 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

Necesitas del panel de MercadoPago:

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

En la misma pantalla 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: 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 Sistema → Métodos de pago → Bre-B y activa el interruptor.

La columna derecha pide la configuración IMAP:

• Email de la cuenta Bre-B — el correo donde Bancolombia envía las notificaciones de transferencia (por ejemplo, tu email empresarial con reenvío).
• Contraseña / token de aplicación — se guarda cifrada; déjala en blanco cuando ya esté configurada y no quieras cambiarla.
• Host IMAP — por ejemplo imap.gmail.com o 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).

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.

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.