Integración con Wordpress / WooCommerce

success
Versión actual del plugin: Cargando...

Requisitos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

  • Servidor con PHP >= 7.4
  • Sitio web construido con WordPress (versión mínima recomendada: 6.1).

Guías de integración

Instalación / Actualización

  1. Descarga el archivo zip del plugin desde aquí (hazlo en modo incógnito).
  2. Ve al área de administración de WordPress.
  3. Navega a Plugins > Agregar nuevo plugin (Plugins > Add new plugin).
  4. Haz clic en Subir plugin (Upload plugin) y selecciona el archivo .zip descargado previamente.
  5. Activa el plugin una vez que se haya completado la instalación.
info

Actualización manual

Dado que el plugin aún no se encuentra en el repositorio de plugins de WordPress, no recibirás notificaciones cuando haya una nueva actualización.

Nuestra recomendación por el momento es que revises con frecuencia esta documentación para saber si existe una nueva versión y actualices el plugin manualmente.

Estamos trabajando para poder ofrecerte notificaciones automáticas.

Panel Administrativo Bold

Es una herramienta centralizada para gestionar configuraciones clave de tu integración con o sin WooCommerce. Aquí puedes habilitar métodos de pago, acceder a enlaces de documentación oficial, y configurar datos esenciales como llaves de identidad y secretas para producción y pruebas. Además, si tienes WooCommerce activado, puedes configurar WebHooks para sincronización automática, actualizar manualmente órdenes pendientes, personalizar el botón de checkout y añadir prefijos a las referencias de las órdenes. Este panel te permite controlar todos los aspectos críticos de la integración de forma eficiente y centralizada. Te llevaremos paso por paso en cada una de las secciones que lo integran.

Requisitos Previos

Se observa los requisitos previos para poder utilizar el plugin de Bold

Tarifas

Consulta las tarifas aplicables para los métodos de pago en la documentación oficial (opens in a new tab).

Configuraciones Generales

En este panel, podrás realizar la configuración del sistema con los siguientes datos generales para los diferentes modos de uso:

Llaves de Producción

  • Llave de Identidad de Producción: Llave proporcionada por Bold para identificar tu cuenta en modo de producción.
  • Llave Secreta de Producción: Llave secreta asociada a tu cuenta para la autenticación en modo de producción.

Llaves de Pruebas

  • Llave de Identidad de Pruebas: Llave proporcionada para probar la integración sin afectar tu entorno de producción.
  • Llave Secreta de Pruebas: Llave secreta para pruebas.

Modo de Uso

Selecciona el modo en el que deseas usar estas llaves:

  • Producción: Para operaciones en vivo.
  • Pruebas: Para realizar pruebas sin impacto real.

También puedes consultar este paso a paso en el siguiente video:


¡Con estas configuraciones, tu integración de Bold con o sin WooCommerce estará lista para funcionar de manera eficiente!

Posibles problemas e incompatibilidades

Moneda incorrecta configurada

Si activaste correctamente el método de pago y las llaves de integración en la configuración pero no aparece Bold en la lista de métodos de pagos en tu página, debes asegurarte de tener configurada tu tienda en pesos colombianos COP, lo puedes realizar siguiendo estos pasos:

  1. Ingresa a tu tienda de WordPress y busca la sección WooCommerce → Ajustes
  2. Navega hacia la parte inferior y busca la sección Opciones de moneda y en el campo Moneda Selecciona peso colombiano ($) - COP
  3. Haz clic en Guardar cambios

Ya debería aparecer Bold en tu página como método de pago.

Jetpack Boost

Este plugin dispone de la opción "Defer Non-Essential JavaScript" que puede afectar a la visualización Botón de pagos Bold.

Recomendación: Se aconseja deshabilitar la opción mencionada al utilizar nuestro plugin para evitar conflictos con la visualización del botón de pagos.

Plugins de caché

Se ha observado que ciertos plugins de caché pueden afectar al correcto funcionamiento de las integraciones realizadas mediante shortcode o botón de pagos con estilo personalizado.

Impacto: La caché puede reutilizar registros importantes necesarios para el correcto funcionamiento de las integraciones mencionadas. Si se está presentando un error con código BTN-002, lo más probable es que se trate de un problema con la caché en WordPress.

Recomendación: Se aconseja excluir en el plugin de caché activo las páginas donde se implementen cualquiera de las integraciones mencionadas para evitar posibles conflictos y garantizar el correcto funcionamiento del botón de pagos.

Incompatibilidad con WooCommerce Suscriptions

Actualmente, no soportamos en nuestro plugin directamente el uso de esta funcionalidad, continuamos mejorando contantemente para brindarte las mejores soluciones.