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 paquete 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

Instala la versión, ejecuta module

, setup
y cache
, y luego 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.