Wompi es la pasarela de pagos respaldada por Bancolombia, diseñada para procesar transacciones en línea mediante PSE, tarjetas de crédito y débito, y puntos de pago en efectivo. Los medios de pago que ofrece dependen de la configuración disponible en la cuenta y en la tienda. En esta guía aprenderás a conectar Wompi en tu tienda; los campos propios de la pasarela siguen pendientes de confirmación.
Conectar Wompi a tu tienda permite que tus cobros ingresen directamente a tu cuenta bancaria sin fricciones operativas. En esta guía conocerás cómo vincular tus credenciales y dejar el método listo para tus clientes.
Antes de empezar
Crea una cuenta en Wompi (wompi.co) y ten a mano tus llaves de API provistas en tu panel de desarrollador.
Verifica tu acceso al panel de administración con permisos de Administrador para configurar pasarelas de pago.
Paso 1: Conectar Wompi en tu tienda — Localiza la pasarela en los ajustes de pago
Inicia sesión en el panel de administración de tu tienda virtual.
En el menú lateral dirígete a WooCommerce > Ajustes y haz clic en la pestaña superior Pagos. En el listado de métodos disponibles, localiza la fila correspondiente a «Wompi» [sin confirmar: rótulo de la pasarela en WooCommerce].
Qué deberías ver: La lista de medios de pago con la opción de Wompi y el botón para gestionar su configuración.
Paso 2: Activa el método y revisa los campos principales
Haz clic en el nombre «Wompi» o pulsa el botón «Gestionar» para acceder a las opciones del módulo.
Marca la casilla «Habilitar Wompi» [sin confirmar: rótulo del control]. En el campo «Título», puedes mantener el nombre oficial o agregar un texto complementario para tus clientes [EJEMPLO: Paga con tarjeta, PSE o Bancolombia].
Qué deberías ver: El formulario con las casillas de texto para ingresar las llaves de seguridad de tu cuenta.
Paso 3: Ingresa tus llaves de comercio
Entra a tu consola de Wompi en otra pestaña y ubica la sección de credenciales de integración.
Copia tus datos y pégalos en las casillas correspondientes del panel de tu tienda:
- «Llave pública» [sin confirmar: rótulo del campo]: cadena que inicia por
pub_prod_(opub_test_si realizas pruebas). - «Llave privada» [sin confirmar: rótulo del campo]: credencial secreta para autenticar transacciones del servidor.
- «Secreto de eventos» [sin confirmar: rótulo del campo]: clave empleada para validar las notificaciones de pago confirmadas.
Qué deberías ver: Las credenciales pegadas en sus campos correspondientes sin espacios en blanco accidentales.
Paso 4: Configura la URL de eventos y guarda
Copia la URL de webhook que muestra el plugin en las instrucciones de la pantalla.
Pega esa dirección en la sección «URL de eventos» [sin confirmar: rótulo del campo] dentro de tu panel de Wompi para que los pedidos se marquen como pagados automáticamente. Luego, regresa a tu tienda y pulsa «Guardar cambios».
Qué deberías ver: El aviso de confirmación indicando que los ajustes fueron guardados con éxito.
Verificación pendiente: las rutas y rótulos nativos de esta pantalla no se encontraron en el código de PLUGINS; aparecen como sin confirmar hasta contrastarlos con el sitio.
Problemas comunes
- El pago no cambia el estado del pedido automáticamente: Revisa que la URL de eventos esté registrada en el portal de Wompi y que tu sitio cuente con certificado SSL activo (https://).
- Aparece un error de credenciales inválidas: Comprueba que no estés usando llaves de pruebas (test) en modo de producción o viceversa.
- El cliente no visualiza la opción de PSE: Asegúrate de que la moneda de tu tienda esté configurada en Pesos Colombianos (COP),; confirma las monedas y métodos admitidos en la configuración vigente de Wompi.
¿Cuánto cobra Wompi por cada venta realizada?
Las tarifas dependen de las condiciones vigentes de Wompi. Consulta su información oficial antes de habilitar el método. [PEDIR AL DUEÑO: confirmar el enlace oficial y las condiciones para Colombia].
¿Puedo probar la pasarela sin cobrar a tarjetas reales?
Sí, puedes activar el modo de pruebas usando las llaves de test y las tarjetas de simulación provistas en la documentación de Wompi.
¿A qué cuenta bancaria llega el dinero de las ventas?
Los fondos se transfieren directamente a la cuenta bancaria de ahorros o corriente que hayas vinculado al registrarte en Wompi.