Documentación del Plugin Efipay para Magento 2.4

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

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.

Instalación y Activación

Paso 1: Descargar el Plugin

1. Descarga el archivo ZIP del plugin desde el siguiente enlace:
   Descargar Plugin Efipay.

Paso 2: Preparar el Directorio del Plugin

1. Descomprime el archivo ZIP descargado.
2. Renombra la carpeta extraída a EfipayPayment.

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.

   

Paso 4: Habilitar el Módulo en Magento

1. Abre una terminal en la raíz de tu instalación de Magento.

2. Ejecuta el siguiente comando:

   bin/magento module:enable EfipayPayment_Embebed --clear-static-content

   

Paso 5: Configurar el Módulo y Refrescar la Caché

1. Ejecuta los siguientes comandos en orden:

   bin/magento setup:upgrade
   bin/magento cache:flush
   bin/magento setup:di:compile
   bin/magento setup:static-content:deploy

   

   ---

Configuración del Plugin

Para configurar correctamente el plugin, sigue estos pasos:

Paso 1: Acceder a la Configuración

1. En el panel de administración de Magento, ve a:
   "Stores" > "Configuration" > "Sales" > "Payment Methods".

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/Documentation/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/Documentation/api-key
   • Token weebhook Token para validar la firmas en las solicitudes Webhook https://sag.efipay.co/Documentation/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

• Haz clic en Guardar Configuración.
• ¡Listo! Tu tienda ya está configurada para aceptar pagos con Efipay.

Vista de Configuración

A continuación, una imagen de referencia de la pantalla de configuración:

Pruebas del Plugin

Antes de activar tu tienda en modo producción, se recomienda realizar pruebas para garantizar la correcta integración.

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.

Activar en Producción

Una vez confirmada la correcta integración:

1. Cambia el ambiente a Producción.
2. Ingresa tus credenciales reales.

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 para más información.

Soporte

Si necesitas ayuda o encuentras algún problema, ponte en contacto con el equipo de soporte de Efipay:

• Sitio web: https://sag.efipay.co/docs/1.0/overview
• Correo electrónico: soporte@efipay.co

Contribuciones y Reporte de Problemas

Para reportar problemas o contribuir al desarrollo del plugin, visita nuestro repositorio de GitHub:
Repositorio en GitHub.