# Documentación del Módulo de Pago para PrestaShop – Efipay Payments --- - [Documentación del Módulo de Pago para PrestaShop – Efipay Payments](#documentacion-del-modulo-de-pago-para-prestashop-efipay-payments) - [Introducción](#introduccion) - [Requisitos del Sistema](#requisitos-del-sistema) - [Instalación del Módulo](#instalacion-del-modulo) - [Paso 1: Descargar el Módulo](#paso-1-descargar-el-modulo) - [Paso 2: Subir e Instalar el Módulo](#paso-2-subir-e-instalar-el-modulo) - [Paso 3: Verificar la Instalación](#paso-3-verificar-la-instalacion) - [Configuración del Módulo](#configuracion-del-modulo) - [Paso 1: Acceder a la Configuración](#paso-1-acceder-a-la-configuracion) - [Paso 2: Completar los Campos de Configuración](#paso-2-completar-los-campos-de-configuracion) - [Paso 3: Realizar una Prueba de Pago](#paso-3-realizar-una-prueba-de-pago) - [Detalle de los Métodos de Pago](#detalle-de-los-metodos-de-pago) - [1. Efipay pago externo (Redirección Externa)](#1-efipay-pago-externo-redireccion-externa) - [2. Efipay pago embebido (Integración Incrustada)](#2-efipay-pago-embebido-integracion-incrustada) - [Solución de Problemas](#solucion-de-problemas) - [Problemas Comunes](#problemas-comunes) - [Habilitar Modo de Depuración](#habilitar-modo-de-depuracion) - [Soporte](#soporte) - [Notas Finales](#notas-finales) ## Introducción [#introduccion] El módulo de pago **Efipay Payments** para PrestaShop permite integrar de manera fácil y segura la pasarela de pago Efipay con tu tienda en línea. Este módulo ofrece dos opciones de pago: 1. **Redirección externa**: El cliente es redirigido a la página segura de Efipay para completar el pago. 2. **Integración incrustada**: El cliente realiza el pago directamente en tu tienda sin salir de la página. Ambos métodos están diseñados para garantizar una experiencia de compra cómoda y segura. --- ## 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: - **PrestaShop:** Versión 8.1.0 o superior. - **PHP:** Versión 7.1 o superior (se recomienda PHP 7.4 o superior). - **SSL:** Certificado SSL configurado en tu tienda para transacciones seguras. - **Cuenta Efipay:** Necesitarás credenciales como el Id Sucursal/Oficina, API Key y Token Webhook. --- ## Instalación del Módulo [#instalacion-del-modulo] ### Paso 1: Descargar el Módulo [#paso-1-descargar-el-modulo] 1. Descarga el archivo comprimido del módulo haciendo clic sobre (efipaypayment.zip) desde el siguiente enlace: [Descargar módulo Efipay](https://github.com/pantherahub/PrestashopPluginEfipay/releases/tag/productionV1.0.0.5). ![config](/images/docs/prestashop/download-zip.png) ### Paso 2: Subir e Instalar el Módulo [#paso-2-subir-e-instalar-el-modulo] 1. Accede al panel de administración de tu tienda PrestaShop. 2. Navega a **Módulos > Administrador de módulos**. 3. Haz clic en el botón **Subir un módulo**. ![config](/images/docs/prestashop/add-new-plugin.png) 4. Selecciona el archivo comprimido descargado y haz clic en **Subir este módulo**. ![config](/images/docs/prestashop/upload.png) 5. Una vez cargado, el módulo se instalará automáticamente. ### Paso 3: Verificar la Instalación [#paso-3-verificar-la-instalacion] 1. Ve a **Módulos > Administrador de módulos > Módulos**. 2. Busca el módulo "Efipay Payments" en la sección "Payment" y verifica que esté instalado y activo. ![config](/images/docs/prestashop/install-verify.png) --- ## Configuración del Módulo [#configuracion-del-modulo] ### Paso 1: Acceder a la Configuración [#paso-1-acceder-a-la-configuracion] 1. Una vez instalado, haz clic en el botón **Configure** que aparece junto al módulo en la lista de módulos. - También puedes acceder a la configuración desde **Módulos > Administrador de módulos** y buscando "Efipay Payments" en la sección "Payment". ![config](/images/docs/prestashop/init-config.png) ### Paso 2: Completar los Campos de Configuración [#paso-2-completar-los-campos-de-configuracion] 1. Proporciona las credenciales requeridas: - **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) - **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) 2. Selecciona los métodos de pago que deseas habilitar: - **Pagar con método external** (Redirección externa). - **Pagar con método embedded** (Integración incrustada). 3. Haz clic en **Guardar**. ![config](/images/docs/prestashop/config.png) ### Paso 3: Realizar una Prueba de Pago [#paso-3-realizar-una-prueba-de-pago] 1. Simula una compra en tu tienda para verificar que los métodos de pago funcionen correctamente. 2. Comprueba que las notificaciones de pago lleguen al panel de administración de PrestaShop. --- ## Detalle de los Métodos de Pago [#detalle-de-los-metodos-de-pago] ### 1. Efipay pago externo (Redirección Externa) [#1-efipay-pago-externo-redireccion-externa] **Descripción:** Este método redirige al cliente a la página de pago segura de Efipay para completar la transacción. ![config](/images/docs/prestashop/use-external.png) **Flujo de Uso:** 1. El cliente selecciona productos y procede al proceso de pago. 2. Elige **Efipay pago externo** como método de pago. 3. Acepta terminos y condiciones. 4. Clic en **Realizar pedido** 5. Es redirigido a la página de Efipay, donde completa la transacción. 6. Una vez completado el pago, el cliente es redirigido automáticamente a tu tienda con una confirmación del pedido. ### 2. Efipay pago embebido (Integración Incrustada) [#2-efipay-pago-embebido-integracion-incrustada] **Descripción:** Este método permite al cliente completar la transacción directamente en tu tienda PrestaShop sin ser redirigido. ![config](/images/docs/prestashop/use-embedded.png) **Flujo de Uso:** 1. El cliente selecciona productos y procede al proceso de pago. 2. Elige **Efipay pago embebido** como método de pago. 3. Completa los datos en el formulario de pago incrustado en tu tienda. 4. Acepta terminos y condiciones. 5. Clic en **Realizar pedido** 6. Una vez confirmado el pago, el cliente recibe un mensaje de éxito en la misma página. --- ## Solución de Problemas [#solucion-de-problemas] ### Problemas Comunes [#problemas-comunes] - **El módulo no se instala:** - Verifica que el archivo ZIP no esté corrupto. - Asegúrate de que tu versión de PrestaShop cumpla con los requisitos. - **Errores en los pagos:** - Confirma que las credenciales (Id Sucursal/Oficina, API Key y Token Webhook) sean correctas. - Revisa que el certificado SSL esté configurado y activo. ### Habilitar Modo de Depuración [#habilitar-modo-de-depuracion] 1. Accede a la configuración del módulo. 2. Activa el **modo de depuración** para registrar detalles de errores. 3. Consulta los registros generados para identificar problemas específicos. --- ## Soporte [#soporte] Si necesitas ayuda adicional con la instalación, configuración o uso del módulo, puedes contactar a nuestro equipo de soporte: - **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) - **Foro de soporte:** Disponible en el sitio oficial de Efipay. --- ## Notas Finales [#notas-finales] - Mantén el módulo y tu tienda PrestaShop actualizados para garantizar compatibilidad y seguridad. - Realiza copias de seguridad de tu tienda antes de instalar nuevos módulos o realizar cambios importantes. ¡Gracias por elegir Efipay como tu proveedor de pagos!