# Documentación del Plugin Efipay Gateway Payment para WooCommerce --- - [Documentación del Plugin Efipay Gateway Payment para WooCommerce](#documentacion-del-plugin-efipay-gateway-payment-para-woocommerce) - [Descripción](#descripcion) - [Requisitos del Sistema](#requisitos-del-sistema) - [Instalación](#instalacion) - [Instalación Manual mediante Archivo ZIP](#instalacion-manual-mediante-archivo-zip) - [Verificación de Instalación](#verificacion-de-instalacion) - [Configuración](#configuracion) - [Paso 1: Accede a la Configuración de Efipay](#paso-1-accede-a-la-configuracion-de-efipay) - [Paso 2: Completa los Campos Requeridos](#paso-2-completa-los-campos-requeridos) - [Paso 3: Guarda la Configuración](#paso-3-guarda-la-configuracion) - [Uso](#uso) - [Proceso para el Cliente](#proceso-para-el-cliente) - [Solución de Problemas](#solucion-de-problemas) - [Soporte](#soporte) - [Versiones de WooCommerce Compatibles](#versiones-de-woocommerce-compatibles) - [Notas Finales](#notas-finales) ## Descripción [#descripcion] El plugin **Efipay Gateway Payment WooCommerce** permite la integración de WordPress-WooCommerce con la pasarela de pagos de Efipay. Este plugin habilita a los clientes de tu tienda en línea a realizar pagos de manera segura y eficiente utilizando Efipay como método de pago. --- ## Requisitos del Sistema [#requisitos-del-sistema] Asegúrate de que tu sistema cumpla con los requisitos que se listan en la parte derecha, antes de instalar el plugin: - **WordPress:** Versión 6.7.1 o superior. - **WooCommerce:** Versión 3.0.0 o superior. - **PHP:** Versión 5.6 o superior (se recomienda PHP 7.4 o superior). - **cURL:** Habilitado en tu servidor. - **SSL:** Certificado SSL para procesar pagos de manera segura. --- ## Instalación [#instalacion] ### Instalación Manual mediante Archivo ZIP [#instalacion-manual-mediante-archivo-zip] 1. Descarga el archivo ZIP del plugin en su versión 2.0.9 (PluginWoocomerceEfipay.zip) desde el [repositorio de GitHub](https://github.com/pantherahub/PluginWoocomerceEfipay/releases/tag/productionV2.2.0). ![config](/images/docs/wordpress/download-zip.png) 2. Ve a tu **panel de administración de WordPress**. 3. Navega hasta **Plugins > Agregar nuevo plugin**. ![config](/images/docs/wordpress/add-new-plugin.png) 4. Haz clic en **Subir plugin** y selecciona el archivo ZIP descargado. ![config](/images/docs/wordpress/upload.png) 5. Haz clic en **Instalar ahora**. ![config](/images/docs/wordpress/install.png) 6. Una vez instalado, haz clic en **Activar plugin**. ![config](/images/docs/wordpress/active.png) ### Verificación de Instalación [#verificacion-de-instalacion] 1. Navega a **Plugins > Plugins instalados** en tu panel de administración. 2. Asegúrate de que **Efipay Gateway Payment WooCommerce** aparezca en la lista y esté activado. ![config](/images/docs/wordpress/install-verify.png) --- ## Configuración [#configuracion] ### Paso 1: Accede a la Configuración de Efipay [#paso-1-accede-a-la-configuracion-de-efipay] 1. Ve a **WooCommerce > Ajustes > Pagos**. 2. Busca "Efipay (tarjetas debito, credito, pse, efectivos)" en la lista de métodos de pago disponibles. 3. Haz clic en el botón **Gestionar** junto a Efipay. ![config](/images/docs/wordpress/init-config.png) ### Paso 2: Completa los Campos Requeridos [#paso-2-completa-los-campos-requeridos] Rellena los campos obligatorios para la integración: - **Habilitar/Deshabilitar Payments Embbebed** Habilita la opción de pago incrustado en tu sitio web - **Moneda** Puede seleccionar la moneda con la cual se realizarán los pagos. - **API Key:** Ingresa la clave API Key que se puede generar en la plataforma Efipay en Documentación >Desarrollador API key > Crear token. [https://sag.efipay.co/documentacion/api-key](https://sag.efipay.co/documentacion/api-key) - **Token weebhook** Token para validar la firmas en las solicitudes Webhook [https://sag.efipay.co/documentacion/api-key](https://sag.efipay.co/documentacion/api-key) - **Id Sucursal/Oficina:** Proporciona el identificador de tu sucursal del comercio. [https://sag.efipay.co/documentacion/api-key](https://sag.efipay.co/documentacion/api-key) - **Página redirección de rechazo** URL de la página que recibe la respuesta cuándo la transacción no fue exitosa; fue rechazada por algún motivo (falta de fondos, error, etc.). - **Página redirección de estado pendiente** La transacción está en proceso, aún no se ha completado ni confirmado. - **Página redirección de confirmación** URL de la página que recibe la respuesta cuándo la transacción fue validada y aprobada con éxito. ### Paso 3: Guarda la Configuración [#paso-3-guarda-la-configuracion] 1. Una vez completados todos los campos, haz clic en el botón **Guardar cambios**. ![config](/images/docs/wordpress/config.png) --- ## Uso [#uso] Una vez configurado correctamente, los clientes podrán seleccionar **Efipay** como método de pago durante el proceso de pago en tu tienda en línea. ### Proceso para el Cliente [#proceso-para-el-cliente] 1. El cliente elige productos y procede al carrito. 2. En la pantalla de pago, selecciona **Efipay** como método de pago. 3. Completa la transacción siguiendo las instrucciones proporcionadas. --- ## Solución de Problemas [#solucion-de-problemas] Si experimentas algún problema durante la instalación o configuración del plugin, revisa lo siguiente: - **Errores comunes:** - Asegúrate de que tu **API Key**, **Token webhook** y **Id Sucursal/Oficina** sean correctos. - Verifica que tu certificado SSL esté correctamente configurado. - Confirma que tu versión de WooCommerce sea compatible. - **Registros de depuración:** - Habilita el modo de depuración en la configuración del plugin para obtener más detalles sobre posibles errores. Para más ayuda, consulta la sección de soporte. --- ## Soporte [#soporte] Si necesitas ayuda adicional con el plugin, contáctanos: - **Correo electrónico:** [soporte@efipay.co](mailto:soporte@efipay.co) - **Documentación en línea:** [https://efipay.co/docs/1.0/overview](https://efipay.co/docs/1.0/overview) --- ## Versiones de WooCommerce Compatibles [#versiones-de-woocommerce-compatibles] - Este plugin ha sido probado y es compatible con **WooCommerce 3.0.0 o superior**. - Se recomienda mantener WooCommerce actualizado para garantizar la compatibilidad con futuras versiones del plugin. --- ## Notas Finales [#notas-finales] Asegúrate de realizar copias de seguridad de tu sitio antes de instalar cualquier plugin nuevo. Mantén actualizado el plugin para acceder a nuevas funcionalidades y correcciones de errores.