Integración con VTEX y Checkout Bold (Redirección)

¡Hola! Bienvenido a la guía de integración de Checkout Bold (Redirección) con VTEX. Estamos muy felices de acompañarte en este proceso para que comiences a recibir pagos de forma sencilla y segura en tu tienda virtual.

Con esta integración, podrás ofrecer a tus clientes sus medios de pago favoritos y gestionar todas tus ventas desde tu Cuenta Bold. 👑

Antes de empezar 📝

Para que la integración sea un éxito, asegúrate de tener a la mano:

1. Acceso como administrador a tu tienda VTEX.
2. Una cuenta activa Bold y acceso como administrador. Si aún no la tienes, puedes crearla en un par de minutos desde nuestra web oficial bold.co .
3. ¡Muchas ganas de hacer crecer tu negocio!

Paso 1: Generar credenciales en VTEX 🔑

Primero, necesitamos que VTEX y Bold se “conozcan”. Para ello, vamos a generar unas llaves de seguridad (App Key y App Token).

1. Ingresa al panel administrativo de tu tienda VTEX en el icono de tu perfil haz clic.
2. Dirígete a Account Settings (Configuración de la cuenta).
3. Selecciona la opción Application Keys (Claves de API).

4. Ahora en la sección Application Keys (Claves de API).
5. Pulsa en Generate New (Generar clave).
   • Tip Pro: En la Identificación de la clave, coloca “Integración Bold” para que la identifiques fácilmente. 💡

6. ¡Importante! Debes seleccionar en Roles los siguientes permisos:
   • Owner (Admin Super)
   • Payments Notifier
7. Haz clic en Generate (Generar).

8. Se generará una URL que al acceder se mostrarán el Key y el New Token. Cópialos y guárdalos en un lugar seguro, ya que el Token solo se mostrará esta vez.

9. Copiar el Nombre de la cuenta principal (Account Name) que aparece en la parte superior del panel o en Account Settings (Configuración de la cuenta) > Account (Cuenta). Lo necesitarás más adelante.

Paso 2: Configurar las llaves en tu cuenta Bold 🔐

Ahora que tienes tus llaves de VTEX, vamos a ponerlas en tu cuenta de Bold para activar el puente de comunicación.

1. Inicia sesión en tu Cuenta de Bold .
2. Ve a la sección de Integraciones > Llaves de integración.
   • Puedes ver mas información acerca de las llaves aquí.
   • Si aún no has generado llaves te aparecerá un botón para hacerlo. Haz clic en Activar llaves.
3. Busca la pestaña Integraciones VTEX y haz clic.
4. Aquí verás todas tus integraciones de tus cuentas de VTEX. Haz clic en Nueva integración.

4. Verás tres campos: pega allí el Nombre de la cuenta, el App Key y el App Token que generaste en el paso anterior.
5. Haz clic en Agregar integración.

¡Listo! Ya estamos conectados.

6. Ahora, dirígete a la pestaña de Botón de pagos en la parte superior y copia las llaves de producción la de Identidad y Secreta que aparecen allí. Las necesitarás en el siguiente paso en tu tienda VTEX.

Paso 3: Configurar el Proveedor de Pagos en VTEX (Gateway) 🛠️

Regresemos a VTEX para decirle a tu tienda que Bold será el encargado de procesar las ventas.

1. En el panel de VTEX, ve a Store Settings (Configuración de la tienda) > Providers (Proveedores).

2. Haz clic en el botón New Provider (Nuevo proveedor) y busca el conector de Bold.

3. Completa el formulario de configuración:
   • Application Key / Token: Usa las que copiaste en el paso anterior desde tu Cuenta Bold.
     • Key: ingresa la llave de Identidad.
     • Token: ingresa la llave Secreta.
   • Control de pago: Desactiva “Activar modo de prueba” para empezar a recibir pagos reales (o actívalo si estás haciendo pruebas técnicas).
   • Liquidación automática: Deja seleccionado en Utilizar comportamiento recomendado por el procesador de pagos.
   • Requires document: Activa esta opción para que tus clientes ingresen su número de identificación al momento de pagar (obligatorio para pagos empresariales y validación 3DS).
   • Campos del proveedor > account_name: Ingresa el Nombre de la cuenta principal que copiaste en el paso 1.
4. Haz clic en Save (Guardar).

5. Aparecerá un mensaje Esta integración requiere que la app Connector Bold esté instalada para funcionar correctamente.
   • Haz clic en el enlace para instalar la aplicación Connector Bold en tu tienda VTEX.
   • Sigue las instrucciones para completar la instalación, da clic en el botón Instalar.

6. Una vez instalada la aplicación, regresa a la sección de Providers (Proveedores) y asegúrate de que el proveedor de Bold esté activo.

Paso 4: Activar Método de Pago 💳

¡Ya casi terminamos! Solo falta elegir el medio de pago de nuestra pasarela para mostrarle a tus clientes.

1. En la misma sección de Store Settings (Configuración de la tienda) > Settings (Configuración).

2. Ve a la pestaña Payment Conditions (Condiciones de pago) y haz clic en el botón ”+”.

3. Selecciona el método “Paga en línea con Bold” del listado de métodos de pago.

4. En el campo Process with affiliation (Procesar con proveedor), asegúrate de seleccionar Bold.
5. Activa el estado de la condición a Enabled (Activo).
6. Da clic en Save (Guardar).

¡Y eso es todo! 🎉

Ya tienes tu tienda VTEX conectada con Bold usando el método de Checkout Bold (Redirección). Ahora tus clientes podrán pagar de forma segura y tú podrás gestionar todas tus ventas desde tu Cuenta Bold.

¿Necesitas ayuda? 🤝

• Documentación adicional:

  • Cómo obtener tus llaves de integración.
  • Ambiente de pruebas para que puedas integrar nuestras soluciones de pago sin tener que usar dinero real durante la fase de desarrollo.
  • Consulta de transacciones varios métodos para que conozcas en qué estado se encuentra cada transacción.

• Soporte técnico: Contacta al equipo de soporte de Bold a través de soporte.online@bold.co

• Soporte de integraciones: Contacta a nuestro experto en integraciones que te podrá ayudar a resolver tus dudas técnicas relacionadas con las integraciones que te ofrecemos aquí.

• Dudas de integración: En esta sección encuentras una guía de resolución de problemas generales de las integraciones con Bold, así como una sección de preguntas frecuentes sobre el botón de pagos.

Esperamos que esta documentación te ayude a aprovechar al máximo Bold desde tu tienda en línea.

#SomosBold 🚀