1
Tú creas el cobro
Desde el módulo de cobros generas un cobro único o un plan recurrente. ConjuntoFácil crea un enlace de pago de Wompi usando tu llave pública.
Volver al Centro de Ayuda
Pagos en línea12 min de lectura
Configurar Wompi para recibir pagos
Aprende para qué sirve el wizard de Wompi, cómo conectar tu cuenta paso a paso y cómo llega el dinero de tus residentes a tu cuenta bancaria.
01
¿Qué hace este wizard?
El wizard conecta tu conjunto con la pasarela Wompi para que cada cobro tenga un enlace de pago en línea (tarjeta, PSE, Nequi). El dinero llega directamente a tu cuenta de Wompi, no a ConjuntoFácil.
Activación
Habilita o deshabilita Wompi como pasarela de pagos del conjunto.
Llave pública
Identifica tu cuenta en el checkout que verán tus residentes.
Llave privada
Autentica las solicitudes que ConjuntoFácil envía a Wompi.
Webhooks
Permite que Wompi notifique cuando un pago se completa.
02
¿Cómo llega el dinero a tu cuenta?
ConjuntoFácil nunca toca el dinero. Solo genera el enlace y registra cuando un cobro se completa. Este es el flujo completo:
2
El residente recibe el enlace
Por email, WhatsApp o desde la app. Al hacer clic, abre el checkout de Wompi a nombre de tu conjunto.
3
El residente paga
Con tarjeta de crédito/débito, PSE, Nequi, Bancolombia Transfer u otros métodos que tengas habilitados en Wompi.
4
Wompi recibe el dinero
El pago entra a TU cuenta de Wompi (no a la de ConjuntoFácil). Wompi descuenta su comisión y deja el resto a tu disposición.
5
Wompi notifica a ConjuntoFácil
Mediante el webhook configurado, Wompi le avisa a la plataforma que el cobro fue pagado. El cobro se marca como PAGADO automáticamente.
6
Wompi te transfiere a tu banco
Según los plazos definidos en tu contrato con Wompi (típicamente 1-2 días hábiles), el dinero pasa de tu cuenta de Wompi a la cuenta bancaria que registraste con ellos.
03
Antes de abrir el wizard
Cuatro requisitos rápidos antes de entrar al wizard.
1
Crea cuenta de comercio en Wompi
Ve a wompi.co y crea una cuenta de comercio (no personal). Necesitas el NIT del conjunto y los datos legales.
2
Aprobación de Wompi
Una vez aprobada, entra al panel de Wompi y ve a Desarrolladores → Llaves de API.
3
Copia tus llaves
Copia las llaves pub_prod_... y prv_prod_... en un lugar seguro. La llave privada solo se muestra una vez.
4
Abre el wizard
En ConjuntoFácil, ve a Configuración → Integraciones → Wompi, y sigue los 4 pasos del wizard.
Crea primero tu cuenta de Wompi
Antes de abrir el wizard necesitas tener una cuenta de comercio activa en wompi.co. Es gratis crearla pero requiere validación de tu negocio.
Guarda las llaves en un lugar seguro
Wompi solo te muestra la llave privada UNA vez al generarla. Si la pierdes, tendrás que regenerarla y volver a configurar el wizard.
Prueba con sandbox antes de producción
Wompi te entrega llaves de prueba (pub_test_..., prv_test_...) para validar el flujo sin mover dinero real. Úsalas en tu primer cobro de prueba.
04
Detalle del wizard
El wizard tiene 4 pasos. Cada paso tiene sus propios campos y reglas.
1
Activación
Activa Wompi como pasarela de pagos del conjunto. Mientras esté apagado, no se generarán enlaces de pago automáticos en los cobros.
Toggle de activación
Cuando lo enciendes, la app empezará a generar enlaces de pago de Wompi en cada cobro. Cuando lo apagas, deja de generarlos pero los pagos en curso siguen procesándose normalmente.
¿Y si lo apago después?
Los cobros existentes mantienen sus enlaces ya generados. Solo los cobros NUEVOS dejarán de tener checkout de Wompi. Puedes volver a encenderlo en cualquier momento.
2
Llave pública
Identifica tu cuenta en el checkout que ven los residentes. Es pública: NO es secreta y puede aparecer en URLs y código del navegador.
Cómo obtenerla
Entra a tu panel de Wompi → Desarrolladores → Llaves de API. Copia la llave que empieza con pub_prod_ (producción) o pub_test_ (pruebas).
Para qué la usa ConjuntoFácil
Cuando el residente abre un enlace de cobro, ConjuntoFácil construye el checkout usando esta llave para que Wompi sepa a qué cuenta corresponde el pago.
3
Llave privada
Autentica las solicitudes que el backend de ConjuntoFácil envía a Wompi (crear enlaces de pago, consultar transacciones, etc). Esta llave SÍ es secreta.
Cómo obtenerla
En el mismo panel de Wompi → Desarrolladores → Llaves de API. Copia la llave que empieza con prv_prod_ o prv_test_. Wompi te la muestra una sola vez al generarla.
¿Quién puede verla?
Una vez guardada, ConjuntoFácil la cifra en base de datos y nadie (ni siquiera el equipo de soporte) puede leerla. Por eso, si la pierdes en Wompi, debes generar una nueva.
4
Webhooks
Wompi necesita avisarle a ConjuntoFácil cada vez que un residente completa un pago. Esto se hace mediante un webhook: una URL que Wompi llama cuando hay eventos.
URL del webhook
El wizard te muestra la URL exacta que debes copiar y pegar en Wompi. Cópiala con el botón del wizard, ve a Wompi → Desarrolladores → Eventos, y pégala como URL de eventos.
Secreto de eventos
Cuando configuras el webhook en Wompi, te entrega un secreto de eventos (otro string como prv_test_integrity_xxx). Cópialo y pégalo en el campo del wizard. Sirve para verificar que las notificaciones realmente vienen de Wompi.
05
Caso práctico · Conjunto Torres del Lago
120 unidades, plan mensual de administración. Quieren que los residentes paguen en línea sin tener que ir al banco.
Lo que hace el administrador
- Crea cuenta de comercio en Wompi a nombre del conjunto.
- Copia las 3 credenciales en el wizard de ConjuntoFácil.
- Activa el plan de cobros mensual existente.
Resultado
Cada mes los residentes reciben un email con su cobro y un botón "Pagar ahora" que abre Wompi. Los pagos se marcan automáticamente y la cartera baja sin trabajo manual. El dinero llega al banco del conjunto en 1-2 días.
06
Checklist de seguridad
Cinco prácticas para mantener tu integración Wompi segura.
- Nunca compartas la llave privada por email o chat.
- Si sospechas que la llave privada se filtró, regenérala en Wompi inmediatamente.
- Usa llaves de prueba (pub_test_, prv_test_) para validar antes de activar producción.
- Verifica que la URL del webhook esté exactamente como la muestra el wizard, sin espacios.
- Después de configurar, haz un cobro de prueba con un valor pequeño para confirmar el flujo.
07
Preguntas frecuentes
¿El dinero pasa por ConjuntoFácil?
No. ConjuntoFácil solo genera el enlace de pago y registra cuando el cobro se completa. El dinero entra directamente a tu cuenta de Wompi y de allí pasa a tu cuenta bancaria según los plazos de Wompi. Nosotros nunca tocamos el dinero.
¿Cuánto cuesta usar Wompi?
Las comisiones por transacción las cobra Wompi directamente, no ConjuntoFácil. Las tarifas dependen del método de pago (tarjeta, PSE, Nequi, etc.) y del volumen de tu negocio. Consulta los precios oficiales en wompi.co/pricing antes de activar.
¿Qué métodos de pago acepta?
Todos los que Wompi tenga habilitados para tu cuenta de comercio: tarjetas de crédito y débito (Visa, Mastercard, American Express), PSE, Nequi, Bancolombia Transfer, Daviplata y otros. Lo configuras desde tu panel de Wompi.
¿Necesito una cuenta empresarial en Wompi?
Sí. Wompi requiere una cuenta de comercio (no personal) para generar enlaces de pago. Si tu conjunto tiene NIT registrado, puedes crearla. El proceso de validación de Wompi puede tomar unos días.
¿Puedo probar antes de activar producción?
Sí. Wompi te entrega llaves de prueba (pub_test_..., prv_test_...) que puedes pegar en el wizard para validar el flujo completo sin mover dinero real. Cuando todo funcione, vuelve al wizard y reemplaza por las llaves de producción.
¿Qué pasa si un residente paga y el cobro no se marca como pagado?
Probablemente el webhook no está bien configurado. Verifica en Wompi → Eventos que la URL y el secreto coincidan exactamente con los del wizard. Mientras lo solucionas, puedes marcar el cobro como pagado manualmente con la opción Registrar pago offline.
¿Puedo desactivar Wompi después de configurarlo?
Sí. Vuelve al wizard y apaga el toggle del paso 1. Los cobros existentes mantienen sus enlaces ya generados, pero los cobros nuevos dejarán de incluir checkout de Wompi. Puedes volver a activarlo en cualquier momento sin perder la configuración.
¿Puedo usar otra pasarela en vez de Wompi?
Por ahora ConjuntoFácil solo integra Wompi como pasarela de pagos automáticos. Si manejas otras formas de pago (consignación, efectivo, transferencia manual), siempre puedes registrarlas con Registrar pago offline en cada cobro.
¿Listo para conectar Wompi?
Abre el wizard desde Configuración → Integraciones en tu panel.