Configura el plugin de Adobe Commerce (Magento)

En ProntoPaga desarrollamos este plugin para integrarse específicamente con Adobe Commerce (antes Magento), permitiéndote aceptar pagos de forma segura, rápida y eficiente. Adobe Commerce es una plataforma de código abierto para personalizar, administrar y optimizar una tienda de comercio electrónico.

Esta guía te llevará paso a paso a través del proceso de instalación, configuración y prueba del plugin de pagos ProntoPaga para Adobe Commerce.

---

Requisitos

Antes de comenzar con la instalación, debes contar con lo siguiente:

• Descargar previamente el archivo .zip del plugin
• Tener permiso de administrador en la tienda de Adobe Commerce donde instalarás el plugin
• Contar con la versión 2.4 hasta 2.4.3 de Magento Commerce Cloud instalada
• Disponer de un certificado SSL de al menos 246 bits
• Acceso a SFTP o terminal del servidor para ejecutar comandos

---

Instalación

Para instalar el plugin de pagos ProntoPaga en Adobe Commerce, sigue estas instrucciones:

1. Sube la carpeta app mediante FTP a la carpeta de instalación de Magento. Ejemplo: /var/www/html/appDeberás ver la carpeta app de ProntoPaga.
2. Ejecuta los siguientes comandos en el directorio raíz de Magento:

$ composer require improntus/module-prontopaga
$ php bin/magento module:enable Improntus_ProntoPaga --clear-static-content
$ php bin/magento setup:upgrade
$ php bin/magento setup:static-content:deploy

3. ¡Listo! El plugin ha sido instalado correctamente. Ahora puedes continuar con la configuración desde el panel de administración de Magento.”.

---

Verificación de la instalación y configuración

Una vez instalado el plugin desde la terminal, termina la configuración, siguiendo estos pasos:

1. Ve al administrador de tu sitio web
2. Dirígete al menú Tiendas -> Configuración
3. Selecciona Ventas -> Métodos de pago
4. Busca ProntoPaga y escribe el Merchant ID, Usuario y Contraseña según el entorno que usarás:
   1. ⚙️ Entorno de integración (pruebas):
   • Las transacciones no serán contabilizadas ni tendrán validez.
   • Te recomendamos no utilizar tarjetas reales.
   • Configuración: debug: Yes
   
   
   1. ✅ Entorno de producción:
   • Las transacciones serán reales y contabilizadas, por lo tanto, debes ingresar tarjetas reales.
   • Configuracióndebug: No

---

Campos de configuración

La siguiente tabla presenta una descripción de todos los campos que debes llenar al configurar el plugin de Magento.

---

Prueba tu integración

Para asegurar el correcto funcionamiento de ProntoPaga en tu cuenta de Adobe Commerce, realiza una prueba de pago siguiendo estos pasos:

1. Ingresa a tu cuenta de Adobe Commerce con tu usuario y contraseña.
2. Selecciona un producto y haz clic Add to Cart.

3. Dirígete al carrito de compras, ubicado en la parte superior derecha de tu página y haz clic en Proceed to Checkout

4. Llena el formulario con tus datos personales y selecciona Next.
5. En esta sección, selecciona el método de pago, ingresa tu documento de identidad y haz clic en Place Order.

6. Completa los campos con los datos de prueba de tu tarjeta.
7. ¡Listo! Recibirás la confirmación del pago en el correo electrónico registrado.

👍

Set de pruebas

Te sugerimos hacer varias pruebas (exitosas y no exitosas) por cada método de pago, para confirmar el correcto funcionamiento del plugin.

---

Solución de problemas comunes

A continuación, se presenta una tabla con los problemas más comunes asociados a esta instalación, así como las soluciones sugeridas.

---

Desinstalación

Si deseas desactivar el plugin, sigue estos pasos:

1. Accede al servidor : Conéctate a tu servidor a través de SSH usando un usuario con los permisos adecuados o el terminal desde tu Cpanel. Por ejemplo: ssh usuario@tuservidor.
2. Cambia al directorio raíz de Magento : Ubica la carpeta donde está instalado Magento: cd /ruta/a/tu/magento
3. Verifica el nombre exacto del módulo: Lista todos los módulos instalados para identificar el nombre del plugin que deseas desinstalar:

• php bin/magento
• module: status . El módulo aparecerá con un formato similar a: Vendor_NombreDelModulo . Apunta el nombre exacto, ya que lo necesitarás para el siguiente paso.

4. Deshabilita el módulo : Desactiva el módulo para evitar que Magento intente cargarlo:

• php bin/magento - module: disable - Vendor_NombreDelModulo

Verifica que se haya deshabilitado correctamente:

• php bin/magento - module: status Debe aparecer en la lista de módulos deshabilitados.

5. Ejecuta el comando de desinstalación : Magento ofrece un comando específico para desinstalar completamente el módulo, incluyendo datos en la base de datos.

• php bin/magento
• module: uninstall
• Vendor_NombreDelModulo
• Advertencia: Este paso elimina datos relacionados con el módulo. Si solo deseas deshabilitarlo sin borrar información, omite este paso.

6. Limpia caché y genera archivos : Después de la desinstalación, limpia la caché y vuelve a compilar:

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

7. Elimina los archivos del módulo (opcional) : Si el plugin fue instalado manualmente, borra la carpeta del directorio app/code o de vendor si fue instalado vía Composer.

• Si fue instalado manualmente: rm -rf app/code/Vendor/NombreDelModulo
• Si fue instalado vía Composer: primero, busca el nombre exacto del paquete: composer show , luego desinstálalo: composer remove - vendor/nombre-del-paquete

8. Verifica el funcionamiento

• Ingresa al Dashboard de Magento y confirma que la tienda funciona correctamente.
• Revisa que el plugin ya no aparezca en Stores > Configuration > Advanced > Advanced.
• Prueba procesos críticos, como el flujo de pago y la carga de productos.
• Listo, habrás desinstalado el plugin.

---

Ayuda con un pedido

Si necesitas ayuda con un pedido o identificas errores persistentes con el plugin, por favor, comunícate con soporte de ProntoPaga al correo electrónico [email protected].

---

Recursos adicionales

Estos son algunos enlaces que podrían ser de utilidad durante este proceso:

• Documentación oficial de Adobe Commerce
• Repositorio de ProntoPaga