¡Atención! Este tutorial corresponde a Magento 2.X

  • Para la integración de Pago Fácil en Magento 1.9, consultar este tutorial
  • Si dispones de Magento 2.X, puedes seguir leyendo

Algunas cosas que debes saber:

  • Magento 2 es una potente plataforma de comercio electrónico escrita en PHP
  • Para instalar nuevos módulos en Magento 2 es común usar Composer, un administrador de paquetes para proyectos escritos en PHP
  • El repositorio oficial de paquetes de Composer se llama Packagist y allí está disponible el módulo de Pago Fácil para Magento 2, de manera que no tienes que descargar ningún archivo y subirlo a tu servidor, pues basta con ejecutar comandos de Composer para obtener el módulo
  • Luego de instalar el paquete del módulo con Composer, es necesario activarlo en Magento 2 a través de comandos que variarán ligeramente en función del tipo de instalación en el servidor, que puede ser una instalación tradicional o una de esas tipo one-click install solution, por lo que es necesario estar familiarizado con el tipo de instalación (ubicación de los archivos, comandos de la terminal, etc.)

Requisitos previos:

  • Crear y activar (si aplica) un Servicio de Pago en Pago Fácil configurado para Magento, del cual tomarás el Id del Servicio (Id Service)
  • Crear un API Token (Token de usuario) en Pago Fácil, haciendo clic en tu nombre de usuario y luego en API Tokens > Crear Token
  • Tener una instalación operativa de Magento 2 con la moneda configurada en pesos chilenos (CLP)
  • Tener acceso a través de SSH y como superusuario o administrador al servidor en el que se encuentra Magento 2, así como estar familiarizado con su gestión mediante comandos de la terminal
  • Tener suficiente memoria RAM o en su defecto, crear un área de intercambio (swap) grande, ya que Composer tienen un alto consumo de memoria y suele fallar por falta de la misma
  • Establecer en -1 el valor de la variable memory_limit en el archivo php.ini para deslimitarle la memoria del sistema a Composer
  • Tener Composer actualizado para evitar errores durante la instalación

Paso a paso:

  • Paso 1: Accede al servidor por SSH, cámbiate a superusuario o administrador y ubícate con el comando cd en la carpeta raíz de Magento 2

Nota:  La ubicación de la carpeta raíz de Magento 2 puede variar en función del tipo de instalación. Si tienes problemas para encontrarla, comunícate con nosotros

  • Paso 2: Con Composer, usa los siguientes comandos para establecer Packagist como el repositorio por defecto, instalar el paquete del módulo y (opcionalmente) restablecer el  repositorio original de Magento 2
composer config repositories.0 composer https://packagist.org/
composer require saulmoralespa/magento2-pago-facil-chile
composer config repositories.0 composer https://repo.magento.com/

Nota: Si la ejecución del segundo comando falla y muestra algún mensaje de error relacionado con requerimientos no resueltos, intenta ejecutar en su lugar el comando composer require saulmoralespa/magento2-pago-facil-chile --ignore-platform-reqs

  • Paso 3: Activa el módulo en Magento 2 a través de los siguientes comandos
php bin/magento module:enable Saulmoralespa_PagoFacilChile --clear-static-content
php bin/magento setup:upgrade
php bin/magento setup:di:compile

Nota: Los comandos de activación pueden variar ligeramente en función del tipo de instalación en el servidor. Si tienes problemas para ejecutarlos, comunícate con nosotros

  • Paso 4: En el backend de tu Magento 2, ve a Tiendas > Configuración y luego a Ventas > Métodos de Pago
  • Paso 5: Ubica el módulo de Pago Fácil al final de la lista y configúralo

Actívalo, colócale un título personalizado y selecciona el ambiente de Producción

Nota: En esta parte, debes seleccionar el ambiente de Producción para recibir pagos reales usando tu cuenta desde https://dashboard.pagofacil.cl/. Si quieres hacer pruebas o usar Pago Fácil en modo sandbox, debes usar tu cuenta desde http://dashboard-dev.pagofacil.cl/ y seleccionar el ambiente de Desarrollo. Los pagos los podrás realizar con tarjetas de prueba

Copia tu API Token y la Id de tu Servicio desde el dashboard correspondiente (producción o desarrollo) y pégalos en los campos correspondientes (producción o desarrollo). El API Token va en el campo Token de usuario y la Id de tu Servicio va en el campo Id Service

Configura los Estados de las Órdenes como se muestra en la imagen. También podrás, opcionalmente, filtrar la disponibilidad del método de pago por países, así como establecer montos mínimos y máximos permitidos

Nota: El comportamiento de los estados de las órdenes en Magento 2 en función de las transacciones con Pago Fácil consistirá en que las transacciones PENDIENTES y FALLIDAS en Pago Fácil se mostrarán como Pending en Magento 2, mientras que las transacciones COMPLETADAS en Pago Fácil se mostrarán como Processing en Magento 2 hasta que se ejecuten los envíos de los productos y queden marcadas como Complete

  • Paso 6: Guarda los cambios y actualiza la caché
  • ¡Y listo! Ya podrás recibir pagos con tarjetas, transferencias y efectivo en Magento 2
¿Encontró su respuesta?