Pagos cripto para WHMCS
Acepta cripto en las facturas de WHMCS. El cliente pulsa Pay Now, paga en la página de SnapEX Pay en USDT en TRON, Ethereum, BSC y otras redes, o en otras monedas convertidas a USDT, y la factura se marca como pagada en WHMCS automáticamente.
Gratis. Versión 1.1.0.
Qué hace
- Sin billeteras ni nodos que mantener: los fondos llegan a tu saldo de comercio en SnapEX Pay.
- Tres vías independientes para marcar una factura como pagada: el webhook firmado, el regreso del cliente desde la página de pago y una comprobación en segundo plano en las ejecuciones del cron de WHMCS (cada pago pendiente como mucho cada 10 minutos, durante 5 días). Un webhook perdido nunca deja sin pagar una factura pagada, y un pago nunca se añade dos veces.
- WHMCS multimoneda: con Convert To For Processing en USD, las facturas se siguen registrando en la moneda del cliente.
- Los pagos parciales nunca se aplican automáticamente: van al Gateway Log para que los revises. Con el webhook configurado, el dinero que llega después de cerrarse la factura de SnapEX Pay también se registra allí.
- Modo de prueba: las facturas de prueba se confirman solas sin dinero real; mientras está activo, solo los administradores con sesión iniciada ven el botón de pago, y los demás clientes ven un aviso de "test mode".
Instalación
- Sube el contenido del archivo a la carpeta raíz de WHMCS respetando las rutas:
modules/gateways/snapexpay.php,modules/gateways/snapexpay/,modules/gateways/callback/snapexpay.php,includes/hooks/snapexpay.php. - En el panel de administración de WHMCS abre System Settings → Payment Gateways → All Payment Gateways y activa SnapEX Pay (Crypto).
- En el panel del comercio de SnapEX Pay crea una clave API con los permisos
invoices.readeinvoices.writey pégala en API key. - Webhook (recomendado): en el panel configura la URL del webhook como
https://<your WHMCS>/modules/gateways/callback/snapexpay.php(la dirección exacta aparece bajo el campo en WHMCS) y pega el secretowhsec_…en Webhook secret. - Si la moneda de tu WHMCS no es USD, pon Convert To For Processing en USD. Las facturas se siguen registrando en la moneda del cliente.
- Activa Test mode, abre una factura sin pagar como administrador, págala en la página de SnapEX Pay con un método de prueba y comprueba que pasa a Paid. Después desactiva el modo de prueba.
Ajustes
| API key | Del panel de SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… de los ajustes de webhook del panel. Sin él, el módulo sigue funcionando mediante la página de retorno y el cron. |
| Network fee paid by | Merchant: el cliente paga exactamente el importe de la factura, y la comisión se descuenta de lo que recibes. Client: la comisión de SnapEX Pay y la comisión de red se suman encima. |
| Payment window, minutes | Cuánto tiempo es válida la página de pago (1–1440, por defecto 60). Si después se vuelve a pulsar Pay Now, se abre una nueva. |
| Test mode | Facturas de prueba; mientras está activo, solo los administradores ven el botón de pago. Los pagos de prueba se ignoran una vez desactivado el modo de prueba. |
| Partner ID | Opcional: el Partner ID del integrador que configuró el módulo (programa de referidos de SnapEX Pay). Déjalo vacío si lo instalas tú mismo. |
| API URL | Déjalo como está. |
Preguntas
¿Qué pasa si el webhook no llega?
La factura se marca como pagada igualmente: el módulo también comprueba el pago cuando el cliente regresa desde la página de pago y en las ejecuciones del cron de WHMCS (cada pago pendiente como mucho cada 10 minutos, durante 5 días). Un pago nunca se añade dos veces.
La moneda de mi WHMCS no es USD. ¿Funcionará?
Sí. Pon Convert To For Processing en USD en los ajustes de la pasarela; las facturas se siguen registrando en la moneda del cliente.
¿Y si el cliente envía menos del importe de la factura?
Si el cliente no completa el pago a tiempo, no se añade nada automáticamente. El Gateway Log recibe una entrada "Partial payment — review and apply manually" con el importe recibido.
¿Y si el dinero llega después de que se cerró la factura de SnapEX Pay?
No se aplica automáticamente en WHMCS. Con el webhook configurado, el Gateway Log recibe una entrada; el dinero está en tu saldo de SnapEX Pay.
¿Puedo probar sin dinero real?
Sí. Activa Test mode: las facturas de prueba se confirman solas, y mientras está activo solo los administradores con sesión iniciada ven el botón de pago.
¿Dónde veo lo que hizo el módulo?
En WHMCS, Billing → Gateway Log. El ID de transacción de un pago es el ID de la factura de SnapEX Pay (inv_…).
Otras integraciones
¿Listo para aceptar cripto?
Crea una cuenta de comercio, obtén una clave API y conecta el módulo. 1% por pago, sin cuota mensual.