Pagos cripto para Remnawave
Acepta USDT en tu panel VPN Remnawave. Este pequeño servicio crea una factura de SnapEX Pay para un plan y envía a tu cliente a la página de pago alojada. Cuando SnapEX Pay confirma el pago, crea el usuario de Remnawave, o renueva uno existente, y te da la URL de suscripción. Se ejecuta junto a tu panel en Docker, y el backend de tu tienda o tu bot de Telegram lo controla mediante una API HTTP con dos endpoints autenticados.
Gratis. Versión 1.1.0.
Qué hace
- Página de pago alojada por SnapEX Pay: USDT en TRON (TRC20), Ethereum (ERC20) o BNB Chain (BEP20); otras monedas aparecen cuando hay una ruta de intercambio disponible para el importe.
- Tras el pago crea un usuario de Remnawave (ACTIVE, con vencimiento, límite de tráfico, ID de Telegram opcional y squads internos) o renueva uno existente. Las renovaciones suman los días del plan a lo que sea posterior: ahora o el vencimiento actual.
- Los webhooks se verifican con HMAC-SHA256 y una ventana de 5 minutos; después el estado de la factura se vuelve a leer desde la API de SnapEX Pay, y solo una factura pagada da de alta al usuario.
- Idempotente: si el mismo webhook llega dos veces, incluso en el mismo momento, el usuario se da de alta solo una vez.
- Planes en una sola variable de entorno; los datos son un único archivo SQLite, sin base de datos externa.
Instalación
- En Remnawave ve a Remnawave Settings → API Tokens y crea un token (no el JWT de inicio de sesión del administrador: el panel lo rechaza para llamadas a la API). Copia los UUID de los squads internos que deben recibir los usuarios nuevos.
- En el panel del comercio de SnapEX Pay crea una clave API con los permisos
invoices.readeinvoices.write. - Descarga y descomprime el archivo, ejecuta
cp .env.example .envy defineSNAPEX_API_KEY,REMNAWAVE_URL,REMNAWAVE_TOKEN,REMNAWAVE_SQUADSy unAPI_TOKENlargo y aleatorio. - Arráncalo:
docker compose up -d, compruebacurl -s http://127.0.0.1:8080/healthy ponlo detrás de tu proxy inverso HTTPS. - En el panel → Developers configura la URL del webhook como
https://<your service>/webhook, pon el secretowhsec_…(se muestra una sola vez, al guardar la URL por primera vez) enSNAPEX_WEBHOOK_SECRETy reinicia. - Desde tu backend o bot llama a
POST /v1/checkoutconAuthorization: Bearer <API_TOKEN>, envíapay_urlal cliente y consultaGET /v1/orders/{invoice_id}para obtener la URL de suscripción.
Ajustes
| SNAPEX_API_KEY, SNAPEX_WEBHOOK_SECRET | Clave API de comercio (invoices.read, invoices.write) y el secreto de firma del webhook (whsec_…). |
|---|---|
| SNAPEX_ENVIRONMENT, SNAPEX_FEE_ON | live o test (las facturas de prueba se confirman sin fondos reales); quién paga la comisión del servicio: merchant o customer. |
| REMNAWAVE_URL, REMNAWAVE_TOKEN | URL del panel (o http://remnawave:3000 en una red Docker compartida) y el token API de Remnawave. |
| REMNAWAVE_SQUADS | UUID de squads internos para los usuarios nuevos. Un usuario sin squad no tiene inbounds, así que su suscripción quedaría vacía. |
| API_TOKEN | Token Bearer que tu tienda o bot envía a /v1/checkout y /v1/orders/…. |
| PLANS | id:days:usd:traffic_bytes, separados por comas; 0 bytes = ilimitado. |
| SNAPEX_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é versiones de Remnawave son compatibles?
Remnawave 2.2 o superior.
¿Por qué la suscripción del usuario nuevo está vacía?
Un usuario sin squad interno no tiene inbounds. Pon los UUID de los squads para usuarios nuevos en REMNAWAVE_SQUADS; los usuarios existentes conservan sus squads.
¿Cómo funcionan las renovaciones?
Un pago para un nombre de usuario existente suma los días del plan a lo que sea posterior: ahora o el vencimiento actual del usuario. El límite de tráfico se fija en el valor del nuevo plan.
¿Puede un mismo pago crear un usuario dos veces?
No. Aunque el mismo webhook llegue dos veces en el mismo momento, el usuario se da de alta solo una vez.
¿Hay un bot de Telegram listo?
Sí, un bot de Telegram de SnapEX Pay aparte para Marzban, 3x-ui y Remnawave. Este servicio encaja cuando ya tienes tu propio bot o tienda.
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.