Saltar a contenido

Integración de 4Geeks Payments con WooCommerce para WordPress

🤖 Explicar con IA

Para las empresas de comercio electrónico que utilizan WordPress, un procesamiento de pagos fluido es fundamental para convertir a los visitantes en clientes. 4Geeks Payments ofrece un plugin robusto, seguro y fácil de usar para desarrolladores, diseñado específicamente para WooCommerce. Al integrar 4Geeks Payments, puede aceptar tarjetas de crédito, tarjetas de débito y billeteras digitales directamente en su tienda, beneficiándose de la facturación automatizada, la protección contra el fraude y las analíticas en tiempo real.

Esta guía lo lleva a través de todo el proceso de instalación y configuración para que su tienda acepte pagos en minutos.

Requisitos previos

Antes de comenzar, asegúrese de tener listo lo siguiente:

  • WordPress & WooCommerce: Un sitio web de WordPress funcional con el plugin WooCommerce instalado y activo.
  • Cuenta de 4Geeks: Una cuenta de comercio activa en 4Geeks Payments.
  • Credenciales de API: Su Client ID y Client Secret únicos. Puede obtenerlos en la sección Settings > API Keys de la 4Geeks Console.
  • Certificado SSL: Su sitio web debe servirse a través de HTTPS para garantizar la transmisión segura de los datos de pago.

Guía de integración paso a paso

Siga estos pasos para conectar 4Geeks Payments a su tienda WooCommerce.

Paso 1: Instalar el plugin de 4Geeks Payments

La forma más sencilla de añadir 4Geeks Payments es a través del Directorio Oficial de Plugins de WordPress.

  1. Inicie sesión en su Panel de Administración de WordPress.
  2. Navegue a Plugins > Add New en el menú de la izquierda.
  3. En la barra de búsqueda, escriba “4Geeks”.
  4. Localice el plugin titulado 4Geeks Payments for WooCommerce.
  5. Haga clic en Install Now.
  6. Una vez instalado, haga clic en Activate para habilitar el plugin en su sitio.

Paso 2: Acceder a la configuración de la pasarela de pago

Después de la activación, debe configurar el plugin para que se comunique con su cuenta de 4Geeks.

  1. En su Panel de WordPress, vaya a WooCommerce > Settings.
  2. Haga clic en la pestaña Payments en la parte superior de la pantalla.
  3. Busque 4Geeks Payments en la lista de pasarelas disponibles.
  4. Haga clic en el botón Manage (o Set up) junto a él, o haga clic directamente en el nombre del método de pago.

Paso 3: Configurar las credenciales de API

Este paso vincula su tienda con el motor de procesamiento de pagos de 4Geeks.

  1. Enable/Disable: Marque la casilla Enable 4Geeks Payments para que esté disponible en el proceso de pago.
  2. Title: Ingrese un título que los clientes verán durante el proceso de pago (por ejemplo, “Pagar con Tarjeta de Crédito”).
  3. Description: Añada una descripción corta (por ejemplo, “Pago seguro a través de Tarjeta de Crédito/Débito”).
  4. API Credentials:
    • Abra una nueva pestaña e inicie sesión en la 4Geeks Console.
    • Navegue a Settings > API Keys.
    • Copie su Client ID y Client Secret.
    • Regrese a su pestaña de WooCommerce y pegue estos valores en los campos correspondientes.
  5. Test Mode: Se recomienda encarecidamente activar el Test Mode (Sandbox) inicialmente. Esto le permite procesar transacciones simuladas sin cobrar dinero real.
  6. Haga clic en Save Changes.

Paso 4: Verificar la integración

Antes del lanzamiento, realice una transacción de prueba para asegurarse de que todo funciona correctamente.

  1. Visite el frontend de su tienda como un cliente.
  2. Añada un producto a su carrito y proceda a Checkout.
  3. Seleccione la opción 4Geeks Payments.
  4. Si está en modo de prueba, utilice un número de tarjeta de crédito de prueba (disponible en la documentación de 4Geeks) para completar la compra.
  5. Si el pedido se realiza con éxito y ve la página de “Pedido recibido”, su integración se ha completado.

Casos de uso comunes

Escenario 1: Proceso de pago de comercio electrónico estándar

Situación: Dirige una tienda de ropa en línea que vende productos físicos. Necesita una forma fiable de aceptar pagos con Visa y Mastercard. Aplicación: Al instalar el plugin de 4Geeks Payments, reemplaza las transferencias bancarias manuales por el procesamiento instantáneo de tarjetas. Resultado: Los clientes disfrutan de un proceso de pago fluido sin salir de su sitio. Los pedidos en WooCommerce se actualizan automáticamente a “Procesando” tras el pago exitoso, activando sus flujos de trabajo de envío de inmediato.

Escenario 2: Suscripciones de membresía digital

Situación: Vende acceso a contenido digital premium o cursos de forma recurrente mensual. Aplicación: 4Geeks Payments se encarga de la tokenización de las tarjetas de los clientes. Al combinarlo con WooCommerce Subscriptions (o con las herramientas nativas de suscripción de 4Geeks), el sistema carga automáticamente la tarjeta del cliente cada mes. Resultado: Reduce la carga administrativa al automatizar la facturación recurrente, garantizando el acceso ininterrumpido a sus suscriptores y unos ingresos constantes para su negocio.

Solución de problemas

Problema 1: Error “401 Unauthorized” o “Credenciales inválidas”

  • Causa: El Client ID o Client Secret introducidos en WooCommerce no coinciden con las credenciales de su 4Geeks Console.
  • Solución: Vuelva a la 4Geeks Console > Settings > API Keys. Regenere sus claves si es necesario y vuelva a copiarlas en WooCommerce, asegurándose de que no se incluyan espacios adicionales.

Problema 2: La página de pago no carga los campos de pago

  • Causa: Esto suele deberse a un conflicto con su tema de WordPress u otro plugin, o porque su sitio no está cargando a través de HTTPS.
  • Solución:
    • Asegúrese de que su sitio tiene un certificado SSL válido y de que se accede a él a través de https://.
    • Cambie temporalmente a un tema predeterminado de WordPress (como Twenty Twenty-Four) para descartar conflictos de tema.
    • Revise la consola de desarrollador de su navegador (F12) para ver si hay errores de JavaScript.

Problema 3: Los pedidos permanecen en estado “Pago pendiente”

  • Causa: La pasarela de pago procesó el cargo con éxito, pero la rellamada (“callback” o webhook) para actualizar WooCommerce falló.
  • Solución: Verifique que su servidor no esté bloqueando las solicitudes entrantes de 4Geeks. Revise el archivo de registro en WooCommerce > Status > Logs para 4geeks-payments para ver mensajes de error específicos sobre tiempos de espera de conexión o fallos de webhooks.

Conclusión

Integrar 4Geeks Payments con WooCommerce dota a su negocio de una solución de pago segura y de nivel empresarial que es fácil de configurar y gestionar. Al seguir esta guía, puede automatizar su recaudación de ingresos y proporcionar una experiencia de pago superior a sus clientes.

Para configuraciones avanzadas o preguntas específicas sobre la API, visite el Centro de ayuda de 4Geeks.