Cobrar con pagos en línea (Wompi)

Con Wompi, Bodegix crea links de pago por el saldo de sus facturas a crédito. El cliente paga desde el link y Bodegix registra el abono solo. El dinero llega a la cuenta de Wompi de su empresa, no a Bodegix.

Antes de empezar

• Para configurar Wompi necesita el permiso Configurar la pasarela de pagos en línea (Wompi) (roles jefe y administrador). Para enviar links, Vender en el POS y facturar o Cobrar cartera (por ejemplo, una auxiliar de cartera que no vende).
• El módulo Pagos en línea debe estar encendido en Configuración > Tipo de empresa y módulos (ver cómo). Viene encendido para distribuidoras, empresas de servicios y "Otro tipo de empresa".
• Necesita una cuenta de comercio en Wompi a nombre de la empresa. De su panel saca tres datos: la llave pública, la llave privada y el secreto de eventos. La pantalla de Bodegix indica que las llaves están en el panel de Wompi, en Desarrolladores.

Conectar Wompi

1. Vaya a Configuración > Pagos en línea.
2. En Ambiente, elija Pruebas (sandbox) para probar sin dinero real, o Producción para cobrar de verdad.
3. En Llave pública, pegue la llave pública. En pruebas empieza por pub_test_ y en producción por pub_prod_.
4. En Llave privada, pegue la llave privada. Empieza por prv_test_ o prv_prod_.
5. En Secreto de eventos, pegue el secreto de eventos que le da Wompi.
6. En URL de eventos para pegar en Wompi, haga clic en Copiar y pegue esa dirección en el panel de Wompi. Así Wompi le avisa a Bodegix cada pago.
7. Marque Activar los links de pago.
8. Haga clic en Guardar configuración.

Qué debe ver al terminar

• El aviso Configuración de pagos en línea guardada.
• Junto al título, la etiqueta Activo.
• La llave privada y el secreto de eventos se guardan cifrados y no se vuelven a mostrar. Los campos quedan vacíos con el texto "Guardada. Déjela vacía para conservarla." Si los deja vacíos al guardar otra vez, se conservan.

Pasar de pruebas a producción

1. En Ambiente, elija Producción.
2. Escriba de nuevo los tres datos, ahora los de producción: Llave pública, Llave privada y Secreto de eventos.
3. Revise que la URL de eventos para pegar en Wompi también esté pegada en la configuración de producción de su cuenta de Wompi.
4. Haga clic en Guardar configuración.

Escriba siempre la llave privada nueva: si deja el campo vacío, Bodegix conserva la guardada, aunque sea la de pruebas.

Enviar un link de pago

1. En Ventas > Ventas, abra una venta a crédito que tenga saldo.
2. En Cobro en línea, haga clic en el botón Crear link de pago por y el saldo.
3. Aparece el link. Haga clic en Copiar link para pegarlo donde quiera, o en Enviar por WhatsApp.
4. Enviar por WhatsApp abre su WhatsApp con un mensaje listo para el celular del cliente, con el valor, el número de la factura y el link. Usted lo envía.

Cuando el cliente paga, Bodegix registra el abono solo, con el medio Pago en línea y la fecha del día. El saldo baja en Cartera (cartera).

• El link es por el saldo de ese momento y sirve para un solo pago. Si ya hay un link por el mismo saldo, Bodegix le muestra ese mismo.
• Si el saldo cambia, por ejemplo porque registró un abono en efectivo, el link anterior queda sin efecto. En la venta sale "Un link anterior quedó sin efecto porque el saldo cambió." Cree uno nuevo por el saldo nuevo.
• Si activó la cobranza por WhatsApp con link de pago, los recordatorios usan este mismo link.

Pagos que entraron sin aplicarse

Puede pasar que el cliente pague un link de una venta que ya se anuló, que ya se pagó por otro lado, o que pague un valor distinto al del link. Bodegix abona a la factura lo que cabe en su saldo, y el resto queda sin aplicar. Lo ve en tres lugares:

• En Configuración > Pagos en línea, en el recuadro Pagos que entraron sin aplicarse, con la factura, el cliente, el motivo y el valor.
• En el Tablero, para quien maneja los pagos en línea (tablero).
• En la venta, con el aviso "El cliente pagó" y el valor "por un link que ya no correspondía al saldo".

El motivo dice "La venta está anulada" o "El saldo ya estaba pagado o el valor no coincide con el link". Qué hacer:

1. Acuerde con el cliente si le devuelve el dinero o lo abona a otra de sus facturas.
2. Para devolverlo, hágalo desde el panel de Wompi.
3. Para abonarlo a otra factura, regístrelo como abono en esa factura (registrar un abono).

Hoy el aviso no se puede cerrar: sigue en la lista aunque ya lo haya resuelto. Además, la parte sin aplicar no genera comprobante contable por sí sola.

Cobranza por WhatsApp

Los recordatorios automáticos de cobro por WhatsApp no se configuran en esta pantalla sino en Configuración > Clientes, y pueden llevar el link de pago de Wompi. Vea Registrar abonos y consultar la cartera por edades.

Si algo no sale

• El botón Guardar configuración está gris: falta la Llave pública.
• "Las llaves no corresponden al ambiente": el Ambiente no coincide con las llaves. En pruebas use llaves que empiecen por pub_test_ y prv_test_; en producción, por pub_prod_ y prv_prod_.
• "Revise un dato: formato no válido": alguna llave quedó mal pegada. Cópiela de nuevo completa desde Wompi.
• "Para activar la pasarela faltan la llave privada y el secreto de eventos": para marcar Activar los links de pago debe escribir los dos.
• No aparece Cobro en línea en la venta: Wompi no está activo, la venta no tiene saldo (es de contado, ya se pagó o se anuló), o usted no tiene permiso para vender ni para cobrar cartera.
• "Configure y active Wompi en Pagos en línea para enviar links de pago": Wompi se desactivó. Revise que Activar los links de pago esté marcado.
• "Wompi rechazó la llave privada; revise la configuración": la llave privada no es válida o no es del ambiente elegido. Péguela de nuevo.
• "Wompi no respondió; intente de nuevo": Wompi no contestó a tiempo. Intente en unos minutos.
• "Wompi no creó el link": Wompi no aceptó el link. Intente de nuevo y, si sigue, escríbanos (cómo pedir ayuda).
• El cliente pagó y el abono no aparece: revise que la URL de eventos para pegar en Wompi esté pegada en Wompi y que el Secreto de eventos sea el correcto y del mismo ambiente. Sin eso, Bodegix no se entera del pago.
• No aparece Enviar por WhatsApp: el cliente no tenía celular en Terceros cuando se hizo la venta, o su teléfono es un fijo (WhatsApp llega a un celular). La pantalla lo dice debajo del link: cópielo con Copiar link y envíelo por otro medio, y agregue el celular en la ficha del cliente.

Relacionado

• Registrar abonos y consultar la cartera por edades
• Anular una venta y hacer una nota crédito
• Encender o apagar módulos
• Crear usuarios y asignar roles

Revisada el 10 de octubre de 2026.