Documentación del Plugin Efipay para Magento 2.4

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

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

Paso 2: Preparar el Directorio del Plugin

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

Paso 3: Mover la Carpeta del Plugin

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

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

Ejecuta el siguiente comando:

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

config

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

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

config

Configuración del Plugin

Para configurar correctamente el plugin, sigue estos pasos:

Paso 1: Acceder a la Configuración

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

Paso 2: Configurar Credenciales

Activa la opción Efipay Checkout.
Selecciona el ambiente:
- Producción: Para transacciones reales, usa producción.
- Pruebas: Para pruebas, usa pruebas.
Ingresa las credenciales de Efipay:
- Id Sucursal/Oficina: Proporciona el identificador de tu sucursal del comercio. 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
- Token weebhook Token para validar la firmas en las solicitudes Webhook 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

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:
Configuración de Efipay

Pruebas del Plugin

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

Realizar Pruebas

Selecciona el ambiente de Pruebas en la configuración del plugin.
Usa las credenciales de prueba proporcionadas en el panel de Efipay.
Realiza transacciones utilizando las tarjetas de prueba.

Activar en Producción

Una vez confirmada la correcta integración:

Cambia el ambiente a Producción.
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://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.