Ir al contenido

Plugins

En esta página

Plugin de WooCommerce

Instala el plugin oficial de Paymos para WooCommerce, conecta las credenciales del proyecto, prueba el pago y actualiza pedidos por webhook firmado.

1. Requisitos

  • WordPress 6.2 o posterior
  • WooCommerce 8.0 o posterior
  • PHP 7.4 o posterior con OpenSSL
  • Una cuenta de Paymos con un proyecto seleccionado en el panel

El paquete incluye el Paymos PHP SDK; no hace falta Composer en la tienda.

2. Instala la versión oficial

Descarga el último paquete en Paymos WooCommerce Releases y luego súbelo y actívalo en Escritorio de WordPress → Plugins → Añadir nuevo → Subir plugin.

Los archivos de la versión oficial son idénticos para todos los comercios y no contienen ninguna clave de API, secreto de API, ID de proyecto, secreto de webhook, access token ni device code.

3. Conecta la tienda

  1. Abre en el panel de Paymos el proyecto que debe recibir las facturas de esta tienda. Ese proyecto actual se usa de forma automática.
  2. Abre WooCommerce → Ajustes → Pagos → Paymos.
  3. Haz clic en Connect Paymos.
  4. Aprueba la petición en la pestaña de Paymos. La página de confirmación muestra la URL de la tienda y el proyecto seleccionado en ese momento; no hay un segundo selector de proyecto.
  5. Vuelve a WooCommerce. La página de ajustes se recarga tras la 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://shop.example.com/wp-json/paymos/v1/webhook

El token de dispositivo de OAuth es de vida corta y se descarta. Las llamadas normales a la Merchant API siguen usando autenticación HMAC.

4. Almacenamiento de credenciales

Las credenciales de Sandbox y Live se validan y se guardan en una opción de WordPress sin autocarga, cifrada con AES-256-GCM. El material de clave se deriva de los security salts de esa instalación de WordPress. Los valores guardados nunca vuelven al navegador y no se pueden introducir ni editar a mano. Vuelve a conectar la tienda después de revocar o rotar una clave o un secreto de webhook.

5. Prueba y paso a producción

  1. Selecciona Sandbox, activa Paymos y haz un pedido de prueba.
  2. Comprueba que la factura aparece en el proyecto de Paymos elegido y que el webhook actualiza el pedido.
  3. Cuando estés listo, selecciona Live. La misma instalación del plugin usa las credenciales de Live ya conectadas.

Si un pedido no se actualiza, revisa WooCommerce → Estado → Registros, comprueba que el sitio es accesible públicamente y verifica que el entorno del pedido coincide con el modo del plugin.

Probar webhooks Plugin de WHMCS