Ir al contenido

Plugins

En esta página

Plugin de WHMCS

Añade pagos en stablecoins a las facturas de WHMCS, conecta Paymos sin escribir ninguna clave, prueba el webhook y conserva tus reglas de aprovisionamiento.

1. Requisitos

  • WHMCS 8.13+ o 9.0 y una URL de sistema pública con HTTPS
  • 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

Extrae el archivo de la versión en la raíz de WHMCS, activa Paymos en Configuración → Ajustes del sistema → Pasarelas de pago y haz clic en Connect Paymos en esa misma página.

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 WHMCS.
  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/modules/gateways/callback/paymosgateway.php

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 un sobre AES-256-GCM dentro de tblconfiguration, con clave derivada del hash de cifrado de la instalación de WHMCS. 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.