Gateway Wompi

La integración Gateway Wompi conecta Yampi con Wompi, la pasarela de pagos de Bancolombia. A diferencia de las demás integraciones, esta no vive en las conversaciones: es parte del motor de cobros de la Tesorería de Yampi. Al configurarla, los cobros a tus inquilinos (canon, administración y otros conceptos) se procesan a través de tu propia cuenta de Wompi, con tus credenciales y tus tarifas, y el dinero llega directo a ti.

¿Qué es Wompi?

Wompi es la pasarela de pagos de Bancolombia: una plataforma que permite a más de 30.000 comercios en Colombia recibir pagos en línea de forma segura. Acepta tarjetas de crédito y débito (Visa, Mastercard, American Express), pagos PSE desde cualquier banco, Nequi y transferencias con el Botón Bancolombia, entre otros medios.

Para una inmobiliaria esto significa una cosa: tus inquilinos pueden pagar el arriendo con el medio que prefieran, y el recaudo entra a tu cuenta con el respaldo de Bancolombia.

Qué es un "gateway" y qué tiene que ver con la Tesorería

En Yampi, los gateways (Wompi, ePayco y Bold) son las pasarelas por donde viaja el dinero de la Tesorería, el módulo que gestiona los cobros a tus inquilinos. La relación es simple:

• La Tesorería decide qué se cobra y a quién (el canon de julio, la administración, etc.).

• El gateway decide por dónde se cobra: procesa el pago con la tarjeta o la cuenta del inquilino.

Al conectar tu propio gateway, Yampi rutea los pagos por tu cuenta de Wompi. Esto tiene dos ventajas grandes:

• El dinero es tuyo desde el primer momento: el recaudo entra a tu cuenta de Wompi (y de ahí a tu banco), no a una cuenta intermedia.

• Tokenización de métodos de pago: Wompi guarda de forma segura la tarjeta o cuenta del inquilino y la convierte en un "token". Con ese token, los cobros recurrentes (como el arriendo de cada mes) se procesan automáticamente sin pedirle los datos de la tarjeta cada vez. Los datos reales nunca se almacenan en Yampi.

Antes de empezar

• Una cuenta de comercio activa en Wompi. Si no la tienes, créala en wompi.com. El registro es gratuito; las tarifas se cobran por transacción según tu plan.

• Ser administrador en Yampi, para poder activar integraciones.

• Acceso al panel de comercios de Wompi (comercios.wompi.co), de donde vas a copiar las llaves.

Nota: Wompi maneja dos ambientes con llaves distintas. Las de Sandbox (empiezan por pub_test_, prv_test_) son para pruebas con dinero de juguete; las de Producción (pub_prod_, prv_prod_) mueven dinero real. Mezclarlas es la causa número uno de errores de conexión.

Paso 1: copia tus llaves desde el panel de Wompi

Este paso se hace fuera de Yampi:

1. Inicia sesión en comercios.wompi.co.

2. Entra a la sección Desarrolladores.

3. Ubica las Llaves del API: allí están la llave pública y la llave privada.

4. Ubica los Secretos para integración técnica: allí están el secreto de Eventos y el secreto de Integridad. Haz clic en mostrar para revelarlos.

5. Copia cada valor completo, sin espacios al inicio o al final. Verifica el prefijo: si vas a hacer pruebas, todos deben ser de test (pub_test_, prv_test_, test_events_, test_integrity_); si vas a cobrar de verdad, todos de producción (pub_prod_, prv_prod_, prod_events_, prod_integrity_).

Importante: la llave privada y los secretos son confidenciales, como la clave de tu banco. No los compartas por chat ni correo, y pégalos únicamente en el formulario de Yampi.

Paso 2: abre la integración en Yampi

1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda.

2. En el menú de Ajustes, haz clic en Integraciones.

3. Ubica la tarjeta Gateway Wompi y haz clic en Configurar.

Paso 3: completa el formulario de credenciales

En la pantalla Gateway Wompi, activa el interruptor Habilitado (arriba a la derecha) y completa los campos:

1. Ambiente: selecciona Sandbox para hacer pruebas sin dinero real, o Producción para cobros reales. Empieza siempre en Sandbox si es tu primera configuración.

2. Llave pública: la llave pub_... que copiaste del panel de Wompi. Identifica tu comercio ante Wompi.

3. Llave privada: la llave prv_.... Es la que autoriza operaciones, por eso es confidencial.

4. Secreto webhook: el secreto con el que se validan las notificaciones de pago que llegan a Yampi, garantizando que vienen de Wompi y no de un tercero.

5. Llave de integridad: el secreto de Integridad (..._integrity_...) de Wompi. Firma cada transacción para que nadie pueda alterar el monto o la referencia en el camino.

6. Llave de eventos: el secreto de Eventos (..._events_...) de Wompi. Verifica la autenticidad de los eventos que Wompi reporta (pago aprobado, rechazado, etc.).

7. Token de aceptación: token asociado a la aceptación de los términos de tratamiento de datos de Wompi (exigencia de la ley colombiana de habeas data para procesar pagos).

8. URL sandbox y URL producción: las direcciones de la API de Wompi para cada ambiente. Salvo indicación contraria de soporte, déjalas con sus valores estándar (https://sandbox.wompi.co/v1 y https://production.wompi.co/v1).

Nota: todas las llaves deben pertenecer al mismo ambiente que seleccionaste arriba. Si eliges Producción pero pegas llaves pub_test_, la conexión fallará.

Paso 4: prueba la conexión y guarda

1. Haz clic en Probar conexión. Yampi verifica las credenciales directamente contra Wompi antes de guardar nada.

2. Si la prueba es exitosa, haz clic en Guardar gateway.

La tarjeta de Gateway Wompi en Integraciones pasará a mostrar la etiqueta Activado, y la Tesorería podrá rutear cobros por tu cuenta de Wompi.

Si la prueba de conexión falla

Revisa en este orden:

1. El ambiente y los prefijos: es el error más común. Ambiente Sandbox exige llaves ..._test_...; ambiente Producción exige llaves ..._prod_.... Todas las llaves del formulario deben ser del mismo juego.

2. Espacios de más: al copiar y pegar se cuela a veces un espacio al inicio o al final. Bórralo en cada campo.

3. Llaves incompletas: verifica que copiaste el valor completo desde el panel de Wompi (usa el botón mostrar y copia todo el texto).

4. El estado de tu cuenta en Wompi: si tu comercio es nuevo o está en revisión, algunos servicios pueden no estar activos todavía. Confírmalo en comercios.wompi.co o con el soporte de Wompi.

Si las llaves son correctas y la prueba sigue fallando, escribe a soporte de Yampi indicando el mensaje de error.

Sandbox: prueba sin arriesgar dinero

El ambiente Sandbox de Wompi es una réplica exacta de la pasarela, pero con dinero de juguete: puedes simular pagos aprobados y rechazados para verificar que todo el flujo de cobro funciona. Ten en cuenta que los dos ambientes son independientes: las transacciones de Sandbox no existen en Producción, y viceversa. Cuando termines las pruebas, cambia el Ambiente a Producción y reemplaza todas las llaves por las de producción.

Cómo deshabilitar el gateway

1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Gateway Wompi.

2. Apaga el interruptor Habilitado y guarda.

Los cobros dejan de rutearse por tu cuenta de Wompi. Tu cuenta de Wompi no se toca: tu historial y saldo siguen intactos en su plataforma.

Preguntas frecuentes

¿Qué diferencia hay entre esta integración y las demás? Las demás integraciones potencian las conversaciones o sincronizan datos. Los gateways (Wompi, ePayco, Bold) son infraestructura de pagos: conectan la Tesorería de Yampi con la pasarela por donde se cobra a tus inquilinos.

¿Qué significa "tokenizar" un método de pago? Wompi guarda la tarjeta o cuenta del inquilino de forma segura y entrega a cambio un "token", un código que la representa. Los cobros recurrentes (como el arriendo mensual) se hacen con ese token, sin volver a pedir la tarjeta y sin que los datos reales pasen por Yampi.

¿El dinero pasa por Yampi? No. Los pagos se procesan directamente en tu cuenta de Wompi con tus propias credenciales. Yampi orquesta el cobro; el dinero va de tu inquilino a tu cuenta.

¿Cuánto cuesta? Yampi no cobra por activar el gateway. Wompi cobra sus tarifas por transacción según el plan que tengas con ellos; consúltalas en wompi.com.

¿Puedo probar antes de cobrar de verdad? Sí. Configura el ambiente Sandbox con las llaves de prueba y simula pagos con dinero de juguete. Cuando todo funcione, cambia a Producción con las llaves reales.

¿Qué pasa si cambio o regenero mis llaves en Wompi? La conexión dejará de funcionar con las llaves viejas. Vuelve a este formulario, pega las llaves nuevas, prueba la conexión y guarda.

¿Necesito saber programar? No. Todo se resuelve copiando y pegando las llaves desde el panel de Wompi. Los términos técnicos (llaves, secretos, tokens) son nombres que usa Wompi, pero el proceso son solo clics.