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.config

Paso 2: Preparar el Directorio del Plugin

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

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

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
    config

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
    config

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".config config

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:

    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

  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:

Contribuciones y Reporte de Problemas

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