Gateway Bold

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 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. 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), 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 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.

Paso 3: completa el formulario de credenciales

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

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

¿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.

¿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.