Integración con Wordpress / WooCommerce
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
- Ve al área de administración de WordPress.
- Navega a Plugins > Agregar nuevo plugin (Plugins > Add new plugin).
- Haz clic en buscador y digita Bold pagos en línea y da clic en instalar.
- Activa el plugin una vez que se haya completado la instalación.
Si no encuentras el plugin puedes descarga el archivo zip del plugin desde aquí (hazlo en modo incógnito) y haz clic en Subir plugin (Upload plugin) y selecciona el archivo .zip descargado previamente.
Actualización automática
Se recomienda activar las actualizaciones automáticas de nuestro plugin, así siempre tendrás la última versión.
Estamos trabajando contantemente en mejoras y nuevas funcionalidades y brindarte una mejor experiencia a ti y tus clientes.
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:
- Ingresa a tu tienda de WordPress y busca la sección WooCommerce → Ajustes
- Navega hacia la parte inferior y busca la sección Opciones de moneda y en el campo Moneda Selecciona peso colombiano ($) - COP
- 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.