Pagos cripto para Xboard y V2Board
Un plugin de pago para los paneles de VPN y proxy Xboard y V2Board. En el checkout el cliente va a la página de SnapEX Pay, paga en USDT en TRC20, ERC20 o BEP20 (u otro método que SnapEX ofrezca para ese importe), y el pedido se activa automáticamente tras un webhook firmado. Sin billetera, nodo ni pasarela autoalojada que mantener; los fondos llegan a tu saldo de comercio en SnapEX Pay.
Gratis. Versión 1.2.0.
Qué hace
- Plugin nativo de Xboard (instalable desde el gestor de plugins del panel de administración) más una clase lista para copiar
app/Payments/SnapexPay.phppara V2Board y versiones antiguas de Xboard. - Unidades de dinero correctas: los totales del panel en centavos se envían como importe decimal en USD, con un tipo de cambio opcional para tiendas que no usan USD.
- Webhooks firmados (HMAC-SHA256, ventana de 5 minutos); la factura se vuelve a leer desde la API de SnapEX Pay y el pedido se marca como pagado solo cuando el estado es paid.
- Un clic repetido en Pagar reutiliza la misma factura; si ha caducado, se abre una nueva para el mismo pedido. Las facturas de prueba nunca pueden activar un pedido mientras el método está en producción.
- La ventana de pago se limita por debajo del tiempo de espera de pedidos del propio panel, así que un cliente no puede pagar un pedido que el panel ya canceló. PHP y cURL puros, sin dependencias adicionales.
Instalación
- Xboard: administración → Plugins → sube el ZIP descargado → Install → activa "SnapEX Pay". (O descomprímelo y pon la carpeta en el panel como
plugins/Snapexpay/—el nombre distingue mayúsculas y minúsculas— y luego instálalo desde Plugins.) - V2Board o Xboard antiguo: copia
app/Payments/SnapexPay.phpdel archivo en el panel y reinicia PHP-FPM u Octane si usas OPcache; en V2Board asegúrate de que Site URL (app_url) está configurada. - Payment configuration → Add payment method → pasarela SnapexPay. Pega la clave API (permisos
invoices.read,invoices.write) del panel de SnapEX Pay. - Copia la notify URL que el panel muestra para este método, añádela como endpoint de webhook en el panel de SnapEX Pay y pega su secreto
whsec_…en Webhook secret. - Si los precios no están en USD, define "USD per 1 shop currency" (por ejemplo
0.14para CNY). Guarda y prueba un pago.
Ajustes
| API key | Panel de SnapEX Pay → API keys, permisos invoices.read e invoices.write. |
|---|---|
| Webhook secret | El secreto whsec_… del endpoint de webhook. Sin una firma válida, ningún pedido se marca como pagado. |
| Network fee paid by | merchant: el cliente paga exactamente el total del pedido. customer: la comisión de red se suma encima. |
| Payment window, minutes | Xboard por defecto 60 (máx. 120), V2Board por defecto 20 (máx. 30): por debajo de los tiempos de espera de pedidos de los propios paneles. |
| USD per 1 shop currency | 1 para precios en USD; por ejemplo 0.14 para CNY. |
Preguntas
¿Funciona con V2Board?
Sí. Xboard recibe un plugin nativo; V2Board y las versiones antiguas de Xboard usan la clase lista para copiar app/Payments/SnapexPay.php con los mismos ajustes.
Mis precios están en CNY u otra moneda.
Define "USD per 1 shop currency": el importe es total / 100 × usd_rate, por ejemplo 0.14 para CNY.
¿Y si el cliente pulsa Pagar dos veces?
Se reutiliza la misma factura; si ha caducado, se abre una nueva para el mismo pedido.
¿Por qué está limitada la ventana de pago?
Xboard cancela los pedidos sin pagar tras 2 horas y V2Board tras 30 minutos, así que la ventana se limita por debajo de eso y un cliente no puede pagar un pedido cancelado.
¿Por qué necesito HTTPS?
SnapEX Pay entrega webhooks solo a URL HTTPS públicas, y el pedido se activa con el webhook.
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.