# Documentación del Plugin Efipay para Magento 2.4 --- - [Documentación del Plugin Efipay para Magento 2.4](#documentacion-del-plugin-efipay-para-magento-24) - [Requisitos](#requisitos) - [Instalación y Activación](#instalacion-y-activacion) - [Paso 1: Descargar el Plugin](#paso-1-descargar-el-plugin) - [Paso 2: Preparar el Directorio del Plugin](#paso-2-preparar-el-directorio-del-plugin) - [Paso 3: Mover la Carpeta del Plugin](#paso-3-mover-la-carpeta-del-plugin) - [Paso 4: Habilitar el Módulo en Magento](#paso-4-habilitar-el-modulo-en-magento) - [Paso 5: Configurar el Módulo y Refrescar la Caché](#paso-5-configurar-el-modulo-y-refrescar-la-cache) - [Configuración del Plugin](#configuracion-del-plugin) - [Paso 1: Acceder a la Configuración](#paso-1-acceder-a-la-configuracion) - [Paso 2: Configurar Credenciales](#paso-2-configurar-credenciales) - [Paso 3: Guardar la Configuración](#paso-3-guardar-la-configuracion) - [Vista de Configuración](#vista-de-configuracion) - [Pruebas del Plugin](#pruebas-del-plugin) - [Realizar Pruebas](#realizar-pruebas) - [Activar en Producción](#activar-en-produccion) - [Notas Adicionales](#notas-adicionales) - [Soporte](#soporte) - [Contribuciones y Reporte de Problemas](#contribuciones-y-reporte-de-problemas) El plugin **Efipay** te permite integrar un formulario de pago embebido en tu tienda Magento, ofreciendo la posibilidad de realizar transacciones con tarjetas de crédito de manera segura y eficiente. --- ## Requisitos [#requisitos] Antes de comenzar la instalación, Asegúrate de que tu sistema cumpla con los requisitos que se listan en la parte derecha: - **PHP**: Versión 7.4 o superior. - **Magento**: Versión 2.4.0 o superior. - **Credenciales de Efipay**: Necesitarás tu API Key, webhook token y el ID de sucursal. Puedes obtenerlos desde el [panel de Efipay](https://sag.efipay.co/documentacion/api-key). --- ## Instalación y Activación [#instalacion-y-activacion] ### Paso 1: Descargar el Plugin [#paso-1-descargar-el-plugin] 1. Descarga el archivo ZIP del plugin desde el siguiente enlace: [Descargar Plugin Efipay](https://github.com/pantherahub/MagentoEfipayPlugin/releases/tag/production). ![config](/images/docs/magento/download-zip.png) ### Paso 2: Preparar el Directorio del Plugin [#paso-2-preparar-el-directorio-del-plugin] 1. Descomprime el archivo ZIP descargado. 2. Renombra la carpeta extraída a `EfipayPayment`. ![config](/images/docs/magento/extract-zip.png) ### Paso 3: Mover la Carpeta del Plugin [#paso-3-mover-la-carpeta-del-plugin] 1. Coloca la carpeta renombrada en la siguiente ubicación dentro de tu instalación de Magento: **`/app/code`** > Nota: Si el directorio `code` no existe, créalo manualmente. ![config](/images/docs/magento/move.png) ### Paso 4: Habilitar el Módulo en Magento [#paso-4-habilitar-el-modulo-en-magento] 1. Abre una terminal en la raíz de tu instalación de Magento. 2. Ejecuta el siguiente comando: ```bash bin/magento module:enable EfipayPayment_Embebed --clear-static-content ``` ![config](/images/docs/magento/enable.png) ## Paso 5: Configurar el Módulo y Refrescar la Caché [#paso-5-configurar-el-modulo-y-refrescar-la-cache] 1. Ejecuta los siguientes comandos en orden: ```bash bin/magento setup:upgrade bin/magento cache:flush bin/magento setup:di:compile bin/magento setup:static-content:deploy ``` ![config](/images/docs/magento/refresh-cache.png) --- ## Configuración del Plugin [#configuracion-del-plugin] Para configurar correctamente el plugin, sigue estos pasos: ### Paso 1: Acceder a la Configuración [#paso-1-acceder-a-la-configuracion] 1. En el panel de administración de Magento, ve a: **"Stores" > "Configuration" > "Sales" > "Payment Methods"**. ![config](/images/docs/magento/init-config.png) ![config](/images/docs/magento/init-config2.png) ### Paso 2: Configurar Credenciales [#paso-2-configurar-credenciales] 1. Activa la opción **Efipay Checkout**. 2. Selecciona el ambiente: - **Producción**: Para transacciones reales, usa **producción**. - **Pruebas**: Para pruebas, usa **pruebas**. 3. Ingresa las credenciales de Efipay: - **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) > Puedes ingresar las credenciales manualmente o automáticamente: - Para la configuración automática, haz clic en **"Iniciar Sesión"**, accede al Efipay Panel, selecciona tu comercio y guarda las credenciales automáticamente. ### Paso 3: Guardar la Configuración [#paso-3-guardar-la-configuracion] - Haz clic en **Guardar Configuración**. - ¡Listo! Tu tienda ya está configurada para aceptar pagos con Efipay. ### Vista de Configuración [#vista-de-configuracion] A continuación, una imagen de referencia de la pantalla de configuración: ![Configuración de Efipay](/images/docs/magento/config.png) --- ## Pruebas del Plugin [#pruebas-del-plugin] Antes de activar tu tienda en modo producción, se recomienda realizar pruebas para garantizar la correcta integración. ### Realizar Pruebas [#realizar-pruebas] 1. Selecciona el ambiente de **Pruebas** en la configuración del plugin. 2. Usa las credenciales de prueba proporcionadas en el panel de Efipay. 3. Realiza transacciones utilizando las [tarjetas de prueba](https://sag.efipay.co/Documentation/test-cards). ### Activar en Producción [#activar-en-produccion] Una vez confirmada la correcta integración: 1. Cambia el ambiente a **Producción**. 2. Ingresa tus credenciales reales. --- ## Notas Adicionales [#notas-adicionales] - Mantén tu instalación de Magento y el plugin actualizados para garantizar compatibilidad y seguridad. - Consulta la [documentación oficial de Efipay](https://efipay.co/docs/1.0/overview) para más información. --- ## Soporte [#soporte] Si necesitas ayuda o encuentras algún problema, ponte en contacto con el equipo de soporte de Efipay: - **Sitio web**: [https://efipay.co/docs/1.0/overview](https://efipay.co/docs/1.0/overview) - **Correo electrónico**: [soporte@efipay.co](mailto:soporte@efipay.co) --- ## Contribuciones y Reporte de Problemas [#contribuciones-y-reporte-de-problemas] Para reportar problemas o contribuir al desarrollo del plugin, visita nuestro repositorio de GitHub: [Repositorio en GitHub](https://github.com/pantherahub/MagentoEfipayPlugin/releases/tag/production). ---