Pagos cripto para BILLmanager
Acepta cripto en BILLmanager. El cliente elige SnapEX Pay (crypto) al recargar saldo o pagar un pedido, 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 el pago se acredita en BILLmanager 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 acreditar un pago: el webhook firmado, el regreso del cliente desde la página de pago y la comprobación periódica (
checkpay). Un webhook perdido nunca deja sin acreditar un pago realizado, y un pago nunca se acredita dos veces. - El importe siempre se vuelve a leer desde la API de SnapEX Pay; el cuerpo del webhook por sí solo nunca acredita nada.
- Los pagos parciales no se acreditan automáticamente: el registro te pide revisarlos.
- Modo de prueba: las facturas de prueba se confirman solas sin dinero real y nunca se acreditan una vez desactivado el modo de prueba.
Instalación
- En el servidor de BILLmanager, como root:
tar xzf snapexpay-billmanager-1.1.0.tar.gz,cd snapexpay-billmanager-1.1.0,sh install.sh. Copia el módulo en/usr/local/mgr5, añade un cron decheckpaycada 5 minutos (/etc/cron.d/snapexpay) como red de seguridad y reinicia BILLmanager. - En el panel del comercio de SnapEX Pay crea una clave API con los permisos
invoices.readeinvoices.write. - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto). Moneda: USD. Pega la clave API; al guardar se comprueba con SnapEX Pay.
- Webhook (recomendado): en el panel configura la URL del webhook como
https://<your billing domain>/mancgi/snapexpayresulty pega el secretowhsec_…en Webhook secret. - Clientes que pagan en otras monedas: BILLmanager convierte el importe a la moneda del método de pago (USD) con sus tipos de cambio, así que mantén actualizado el tipo de cambio del USD.
- Prueba primero: un método de pago aparte con Test mode activado, disponible solo para un cliente de prueba (Payment methods → restricciones por grupo de clientes). Después desactiva el modo de prueba o elimínalo.
Ajustes
| API key | Del panel de SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… de los ajustes de webhook del panel. Sin él, los pagos se siguen acreditando cuando el cliente regresa y con la comprobación periódica. |
| Client pays the network fee | Desactivado: el cliente paga exactamente el importe del pago, y la comisión se descuenta de lo que recibes. Activado: 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 de SnapEX (1–1440, por defecto 60). Si después se vuelve a abrir el pago, se crea una página nueva. |
| Test mode | Facturas de prueba sin dinero real. Los pagos de prueba nunca se acreditan una vez desactivado. |
| API URL | Déjalo vacío. |
| 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. |
Preguntas
¿Qué ediciones de BILLmanager son compatibles?
BILLmanager 6, cualquier edición. El módulo solo necesita python3 3.6+ con la biblioteca estándar en el servidor de BILLmanager.
¿Qué pasa si el webhook no llega?
El pago se acredita igualmente cuando el cliente regresa desde la página de pago o con la comprobación periódica que se ejecuta cada 5 minutos. Un pago nunca se acredita dos veces.
Mis clientes pagan en rublos u otras monedas. ¿Funcionará?
Sí. El método de pago está en USD, y BILLmanager convierte el importe con sus tipos de cambio; mantén actualizado el tipo de cambio del USD.
¿Y si el cliente envía menos de lo necesario?
Si el cliente no completa el pago a tiempo, no se acredita nada y el registro indica "closed with a PARTIAL payment (…) - review in SnapEX Pay and credit manually".
¿Y si el cliente no paga a tiempo?
El pago queda en "In payment" para que el cliente pueda intentarlo de nuevo; un día después de que caduque la última factura de SnapEX, se cancela.
¿Cómo desinstalo el módulo?
Ejecuta sh install.sh --uninstall. El historial de pagos se conserva en var/snapexpay.sqlite. Todo lo que hace el módulo se registra en /usr/local/mgr5/var/pmsnapexpay.log.
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.