Ir al contenido

Plugins

En esta página

Plugin de Magento 2

Instala el módulo de Paymos para Magento 2 o Adobe Commerce, conecta las credenciales de prueba y reales y verifica el flujo de estados del pedido a la factura.

1. Requisitos

  • Magento Open Source o Adobe Commerce 2.4.x y acceso por línea de comandos
  • Una cuenta de Paymos con un proyecto seleccionado en el panel
  • El módulo en sí: mediante Composer desde el Adobe Commerce Marketplace o el ZIP oficial de GitHub Releases

Los paquetes oficiales son idénticos para todos los comercios y no contienen claves de API, secretos de API, IDs de proyecto, secretos de webhook, tokens de OAuth ni device codes.

2. Instalación

Magento no tiene un cargador de extensiones en la administración, así que ambos caminos terminan en los mismos comandos de consola. Primero elige cómo llegan los archivos.

Adobe Commerce Marketplace. Cuando el módulo esté publicado allí, Composer trae el módulo y el SDK de PHP de Paymos juntos:

composer require paymos/magento2-payment

ZIP del panel. Descarga paymos-magento2-<version>.zip de GitHub Releases o del panel Integración CMS del dashboard de Paymos, y extráelo en la raíz de Magento. El archivo ya viene estructurado como app/code/Paymos/Payment/… con el SDK incluido: no hay que mover nada ni hace falta Composer.

Cualquiera de los dos caminos se completa con los mismos comandos:

bin/magento module:enable Paymos_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile   # solo en modo producción
bin/magento cache:clean

setup:upgrade crea dos tablas: paymos_payment_invoice, una instantánea por pedido, y paymos_payment_event, el registro de deduplicación de webhooks. Después abre Tiendas → Configuración → Ventas → Métodos de pago → Paymos y haz clic en Connect Paymos.

3. Conexión

  1. Abre en el panel de Paymos el proyecto que quieres conectar. El plugin usa ese proyecto actual de forma automática y nunca te pide elegirlo otra vez.
  2. Haz clic en Connect Paymos dentro de Magento 2.
  3. Aprueba en Paymos la URL de la tienda y el proyecto actual que se muestran. No hay un segundo selector de proyecto.
  4. Vuelve al CMS cuando aparezca el estado de conexión.

Para Sandbox y Live, Paymos reutiliza la única clave Payment activa del comercio o crea una si no existe ninguna. Reutiliza un webhook solo cuando coinciden exactamente la URL de callback, la categoría Invoice y el proyecto actual; si no, crea un webhook Invoice propio. Un webhook en conflicto en la misma URL nunca se sobrescribe en silencio:

https://your-store.example/paymos/payment/callback

La autorización de dispositivo de OAuth es solo el canal de entrega de una sola vez. El token de vida corta se descarta; las llamadas en marcha a la Merchant API siguen firmadas con HMAC.

4. Almacenamiento de secretos

Las credenciales y el estado temporal del dispositivo se guardan en core_config_data, cifrados con el EncryptorInterface de Magento y la clave de cifrado de la instalación. Los secretos guardados no se devuelven a la página de administración.

5. Prueba y paso a producción

Selecciona Sandbox, haz un pedido de prueba y comprueba la factura y el cambio de estado que dispara el webhook. Cuando estés listo, pasa esa misma instalación a Live; solo tendrás que volver a conectar si cambias la URL de la tienda, revocas una clave Payment o rotas un secreto de webhook.

Plugin de CS-Cart Plugin de Shopware 6