Pagos cripto para WISECP
Acepta cripto en facturas y pedidos de WISECP. El cliente elige SnapEX Pay — cripto (USDT y otras monedas), 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 queda pagada en WISECP automáticamente.
Qué hace
- Sin billeteras ni nodos que mantener: los fondos llegan a tu saldo de comerciante en SnapEX Pay.
- El pago se registra con el webhook firmado o en cuanto el cliente vuelve de la página de pago, lo que ocurra primero. En ambos casos la factura se vuelve a leer primero desde la API de SnapEX Pay: el cuerpo del webhook por sí solo nunca marca nada como pagado, y un pago nunca se registra dos veces.
- Si el cliente vuelve antes de que se confirme el pago, ve una página de estado que comprueba cada 10 segundos y pasa sola a la página «pago realizado» de WISECP.
- Los pagos parciales se notifican como pendientes, con el importe recibido en la nota del pago, para que los revises antes de aprobarlos.
- Modo de prueba: las facturas de prueba se confirman solas sin dinero real; mientras está activo, solo un administrador con sesión iniciada ve el botón.
- Sin tablas extra en la base de datos: el módulo guarda sus datos en el checkout de WISECP. Textos del panel en inglés, turco y ruso.
- Monedas: USDT (TRC20, ERC20, BEP20) en facturas de cualquier importe; BTC, ETH, LTC y TRX, también en facturas menores si la comisión de red lo permite; las demás monedas, en facturas desde $8.
Instalación
- Sube el contenido del archivo a la carpeta raíz de WISECP, conservando la ruta
coremio/modules/Payment/SnapexPay/. - En el panel de WISECP abre la configuración de pasarelas de pago, busca SnapEX Pay (Crypto) entre los módulos, actívalo y abre su configuración. En WISECP 5: Payment Gateways → añádelo en Enabled Module Selection, guarda y abre su tarjeta.
- En el panel de comerciante de SnapEX Pay crea una API key con los permisos
invoices.readeinvoices.writey pégala en API key. - En el panel añade un webhook con la URL que aparece bajo Webhook secret (
https://<tu WISECP>/payment/SnapexPay/<token>/callbacken WISECP 3,…/payments/SnapexPay/<token>/callbacken WISECP 5; cópiala de la página de configuración) y pega el secretowhsec_…en Webhook secret. El webhook es la vía por la que llegan los pagos cuando el cliente no vuelve al sitio. - Si tus facturas no están en USD, mantén USD entre las monedas de WISECP con un tipo de cambio: el módulo convierte el importe a USD con los tipos de WISECP. Si configuras la pasarela para convertir a USD, WISECP entrega el importe en USD y no hace falta convertir.
- Activa Test mode, sin cerrar la sesión de administrador abre una factura pendiente en el área de cliente en el mismo navegador, págala con un método de prueba en la página de SnapEX Pay y comprueba que queda pagada. Después desactiva el modo de prueba.
Ajustes
| API key | Del panel de SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… de la configuración del webhook en el panel. La URL del webhook aparece bajo el campo. |
| Network fee paid by | Merchant: el cliente paga exactamente el importe de la factura. Client: la comisión se suma encima. |
| Payment window, minutes | Cuánto tiempo es válida la página de pago (1–1440, 60 por defecto). Si se paga más tarde, se abre una nueva. |
| Test mode | Facturas de prueba, solo para administradores con sesión iniciada. Los pagos de prueba se ignoran al desactivar el modo. |
| 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 configuras tú. |
| API URL | Déjalo como está. |
Preguntas
¿Con qué versiones de WISECP funciona?
Con WISECP 3 y WISECP 5. Se comprobó de principio a fin en una instalación real de WISECP 5.0-beta.3: webhook, regreso del cliente y webhook tardío después del regreso, un pago en cada caso.
¿Para qué añadir el webhook?
Si el cliente paga y no vuelve al sitio, el webhook firmado es la vía por la que el pago llega a WISECP. Si el cliente vuelve, el pago se registra al momento y nunca dos veces.
Mis facturas no están en USD. ¿Funciona?
Sí. Mantén USD entre las monedas de WISECP con un tipo de cambio y el módulo convertirá el importe con los tipos de WISECP. O configura la pasarela para convertir a USD, y WISECP entregará el importe en USD.
¿Qué aparece en WISECP cuando se paga una factura?
El pago se notifica como correcto y WISECP marca la factura (o el pedido) como pagada. El ID de transacción es el número de factura de SnapEX Pay (INV-…), y la nota del pago indica con qué pagó el cliente.
¿Y si el cliente envía menos del importe de la factura?
Si el cliente no completa a tiempo, el pago se notifica como pendiente con el importe recibido en la nota. Revísalo antes de aprobarlo.
¿Y si la página de pago caduca sin pago?
No se registra nada y el cliente puede volver a pagar. Si llega dinero después de cerrar la factura, se anota en el registro de módulos de WISECP; el dinero está en tu saldo de SnapEX Pay.
¿Dónde veo lo que hizo el módulo?
En el registro de módulos de WISECP: ahí se anotan los errores de la API y cada pago registrado. La API key y el secreto del webhook nunca se registran.
Otras integraciones
-
WHMCS
Facturación de hosting
-
BILLmanager Facturación de hosting
-
FOSSBilling Facturación de hosting
-
Paymenter
Facturación de hosting
- Blesta Facturación de hosting
- RootPanel Facturación de hosting
-
WooCommerce
Tiendas online
-
CS-Cart
Tiendas online
- Xboard / V2Board Paneles VPN
-
Marzban Paneles VPN
-
3x-ui
Paneles VPN
-
Remnawave
Paneles VPN
-
Bot VPN de Telegram Paneles VPN
-
n8n Automatización
¿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.