Módulo PayU Latam para WHMCS

Este es un módulo sencillo para integrar PayU Latam en WHMCS mediante Web Checkout.

⚠️ Importante: Este módulo es básico y no profesional. Puede requerir ajustes según tu versión de WHMCS o necesidades específicas. Úsalo bajo tu propia responsabilidad. Aunque está implementado con firma SHA-256 en el callback y MD5 en el formulario, no hay garantía absoluta de seguridad frente a configuraciones incorrectas.

---

Archivos incluidos

• modules/gateways/payu.php → Lógica principal del módulo y generación del formulario de pago.
• modules/gateways/callback/payu.php → Callback que procesa los pagos recibidos desde PayU.

---

Instalación

1. Subir los archivos a tu instalación de WHMCS:

modules/gateways/payu.php modules/gateways/callback/payu.php

2. Ingresar al WHMCS Admin Panel:

Setup → Payments → Payment Gateways → Activate/Configure

3. Activar PayU Latam y llenar los campos:

Campo	Descripción
Merchant ID	Identificador de tu comercio en PayU
Account ID	ID de cuenta asignado por PayU
API Key	Clave secreta proporcionada por PayU
Test Mode	Activar modo pruebas si deseas simular pagos

4. Guardar la configuración.

---

Uso

1. Al generar una factura en WHMCS, el módulo mostrará un botón:

[Pagar con PayU]

2. El cliente será redirigido a PayU con un formulario seguro, incluyendo:

• merchantId
• accountId
• amount
• currency
• description
• referenceCode (único por transacción)
• signature (MD5)
• responseUrl y confirmationUrl

3. PayU procesará el pago y enviará la confirmación al callback:

• Se valida la firma SHA-256
• Se verifica que la transacción esté aprobada (state_pol = 4)
• Se registra el pago en WHMCS

---

Seguridad

• El callback utiliza SHA-256 para validar la autenticidad de los pagos.
• La referencia de la factura (referenceCode) se genera única por intento, evitando pagos duplicados.

---

Limitaciones

• Módulo básico: puede requerir cambios según tu versión de WHMCS o PayU.
• No incluye manejo avanzado de errores o devoluciones automáticas.
• Es responsabilidad del usuario mantener seguras las credenciales.
• La firma del formulario es MD5, que es suficiente para Web Checkout, pero no es ideal para seguridad máxima.