La integración **Gateway Bold** conecta Yampi con **Bold**, la fintech colombiana conocida por sus datáfonos y su pasarela de pagos en línea. Al igual que Gateway Wompi y Gateway ePayco, esta integración 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 Bold**, con tus credenciales y tus tarifas, y el dinero llega directo a ti.

## ¿Qué es Bold?

[Bold](https://bold.co) es una empresa colombiana de pagos que se hizo conocida por sus datáfonos para pequeños y medianos negocios, y que hoy también ofrece una **pasarela de pagos en línea** completa. Acepta tarjetas de crédito y débito (Visa, Mastercard, entre otras), pagos **PSE** desde cualquier banco, **Nequi** y otras billeteras, e incluso cobros internacionales con conversión de moneda.

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 de Bold.

## 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 Bold**. Esto tiene dos ventajas grandes:

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

* **Tokenización de métodos de pago**: la pasarela guarda de forma segura la tarjeta 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 Bold.** Si no la tienes, créala en [bold.co](https://bold.co). El registro es gratuito; Bold cobra sus tarifas por transacción.

* **Ser administrador en Yampi**, para poder activar integraciones.

* **Acceso al panel de comercios de Bold** ([panel.bold.co](https://panel.bold.co)), de donde vas a copiar las llaves.

**Nota:** Bold entrega llaves separadas para **pruebas** y **producción**. Las de producción solo aparecen cuando tu comercio ha sido verificado por el equipo de Bold. Si tu cuenta es nueva y aún no está verificada, podrás hacer pruebas, pero no recibir pagos reales.

## Paso 1: copia tus llaves desde el panel de Bold

Este paso se hace **fuera de Yampi**:

1. Inicia sesión en [panel.bold.co](https://panel.bold.co) con la cuenta del comercio que quieres conectar.

2. En el menú lateral, entra a la sección **Integraciones**.

3. Si es tu primera vez, haz clic en **Activar llaves**; en unos segundos aparecerán las llaves. Selecciona el tipo de integración **API**.

4. Verás dos llaves por ambiente: la **llave de identidad** (también llamada API key: es pública e identifica tu comercio) y la **llave secreta** (privada: garantiza la seguridad de la comunicación con Bold).

5. Copia cada valor completo, sin espacios al inicio o al final, empezando por las llaves del ambiente en que vas a trabajar (pruebas o producción).

**Importante:** la **llave secreta** es confidencial, como la clave de tu banco. No la compartas por chat ni correo, y pégala ú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 Bold** y haz clic en **Configurar**.


![](https://app.yampi.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMCt2QVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--af7c6e0b23be6fd4d4fd803b3faf7d93a81b9821/image.png)

## Paso 3: completa el formulario de credenciales

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

![](https://app.yampi.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMU92QVE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--feac9d4fc7c2df8e1a1fcb4c59d5859849e19fbc/image.png?cw_image_width=637px)

1. **URL sandbox** y **URL producción**: las direcciones de la API de Bold para cada ambiente. Salvo indicación contraria de soporte, déjalas con sus valores por defecto.

2. **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.

3. **Llave privada**: la **llave secreta** de Bold. Es la que autoriza operaciones, por eso es confidencial.

4. **Llave pública**: la **llave de identidad** (API key) que copiaste del panel de Bold. Identifica tu comercio ante Bold.

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

**Atención:** en Bold las llaves de pruebas y de producción son **distintas**. Asegúrate de que las llaves que pegas correspondan al ambiente que seleccionaste: llaves de pruebas con **Sandbox**, llaves de producción con **Producción**.

Mientras falten credenciales, verás un aviso amarillo en la parte superior: *"Agrega las credenciales requeridas antes de cambiar Treasury a gateways propios de la cuenta"*. Es normal: desaparece cuando completas y guardas la configuración.

## Paso 4: prueba la conexión y guarda

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

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

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

## Si la prueba de conexión falla

Revisa en este orden:

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

2. **Llaves de otro ambiente**: es el error más común con Bold. Si el selector está en **Sandbox** pero pegaste las llaves de producción (o al revés), la prueba falla. Verifica que ambiente y llaves coincidan.

3. **Llaves incompletas o intercambiadas**: verifica que copiaste cada valor completo y en el campo correcto (la llave de identidad en **Llave pública**, la secreta en **Llave privada**).

4. **El estado de tu cuenta en Bold**: si tu comercio aún no ha sido verificado, las llaves de producción no estarán disponibles. Confírmalo en [panel.bold.co](https://panel.bold.co) o con el soporte de Bold.

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

Con el ambiente **Sandbox** puedes simular pagos aprobados y rechazados para verificar el flujo de cobro completo sin mover dinero real, usando las **llaves de pruebas** de Bold. Cuando todo funcione, cambia el **Ambiente** a **Producción**, reemplaza las llaves por las de **producción** (recuerda: en Bold son distintas), vuelve a probar la conexión y guarda.

## Cómo deshabilitar el gateway

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

2. Apaga el interruptor **Habilitado** y guarda.

Los cobros dejan de rutearse por tu cuenta de Bold. Tu cuenta de Bold 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.

**Ya uso el datáfono de Bold en mi oficina, ¿me sirve la misma cuenta?** Sí. La cuenta de comercio de Bold es una sola: la misma que usas para el datáfono te sirve para los pagos en línea. Solo necesitas activar las llaves de integración en [panel.bold.co](https://panel.bold.co).

**¿Qué significa "tokenizar" un método de pago?** La pasarela guarda la tarjeta 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 Bold 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. Bold cobra sus tarifas por transacción según las condiciones de tu cuenta; consúltalas en [bold.co](https://bold.co).

**¿Qué pasa si cambio o regenero mis llaves en Bold?** 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 Bold. Los términos técnicos (llave de identidad, API key) son nombres que usa Bold, pero el proceso son solo clics.