PT
Русский English فارسی 中文 Español Português
Painéis de VPN

Pagamentos em cripto para Remnawave

Receba USDT no seu painel de VPN Remnawave. Este pequeno serviço cria uma fatura da SnapEX Pay para um plano e envia o seu cliente para a página de pagamento hospedada. Quando a SnapEX Pay confirma o pagamento, ele cria o usuário no Remnawave, ou renova um existente, e entrega a URL da assinatura. Ele roda ao lado do seu painel no Docker, e o backend da sua loja ou o seu bot do Telegram o controla por uma API HTTP com dois endpoints autenticados.

Baixar o módulo

Grátis. Versão 1.1.0.

O que faz

  • Página de pagamento hospedada pela SnapEX Pay: USDT nas redes TRON (TRC20), Ethereum (ERC20) ou BNB Chain (BEP20); outras moedas aparecem quando há uma rota de swap disponível para o valor.
  • Após o pagamento, cria um usuário no Remnawave (ACTIVE, com vencimento, limite de tráfego, ID do Telegram opcional e squads internos) ou renova um existente. Nas renovações, os dias do plano são somados a partir de agora ou do vencimento atual, o que for mais tarde.
  • Os webhooks são verificados com HMAC-SHA256 e janela de 5 minutos; em seguida, o status da fatura é relido na API da SnapEX Pay, e só uma fatura paga provisiona o usuário.
  • Idempotente: se o mesmo webhook chegar duas vezes, mesmo no mesmo instante, o usuário é provisionado uma única vez.
  • Planos em uma única variável de ambiente; os dados ficam em um só arquivo SQLite, sem banco de dados externo.

Instalação

  1. No Remnawave, vá em Remnawave Settings → API Tokens e crie um token (não o JWT de login do administrador — o painel o recusa em chamadas de API). Copie os UUIDs dos squads internos que os novos usuários devem receber.
  2. No painel do comerciante da SnapEX Pay, crie uma chave de API com os escopos invoices.read e invoices.write.
  3. Baixe e descompacte o arquivo, execute cp .env.example .env e defina SNAPEX_API_KEY, REMNAWAVE_URL, REMNAWAVE_TOKEN, REMNAWAVE_SQUADS e um API_TOKEN longo e aleatório.
  4. Inicie o serviço: docker compose up -d, verifique com curl -s http://127.0.0.1:8080/health e coloque-o atrás do seu proxy reverso com HTTPS.
  5. No painel → Desenvolvedores, defina a URL do webhook como https://<your service>/webhook, coloque a chave secreta whsec_… (exibida uma única vez, ao salvar a URL pela primeira vez) em SNAPEX_WEBHOOK_SECRET e reinicie.
  6. No seu backend ou bot, chame POST /v1/checkout com Authorization: Bearer <API_TOKEN>, envie pay_url ao cliente e consulte GET /v1/orders/{invoice_id} para obter a URL da assinatura.

Configurações

SNAPEX_API_KEY, SNAPEX_WEBHOOK_SECRETChave de API do comerciante (invoices.read, invoices.write) e a chave secreta de assinatura do webhook (whsec_…).
SNAPEX_ENVIRONMENT, SNAPEX_FEE_ONlive ou test (faturas de teste são confirmadas sem dinheiro real); quem paga a taxa de serviço — merchant ou customer.
REMNAWAVE_URL, REMNAWAVE_TOKENURL do painel (ou http://remnawave:3000 em uma rede Docker compartilhada) e o token de API do Remnawave.
REMNAWAVE_SQUADSUUIDs dos squads internos para novos usuários. Um usuário sem squad não tem inbounds, então a assinatura dele ficaria vazia.
API_TOKENToken Bearer que sua loja ou bot envia para /v1/checkout e /v1/orders/….
PLANSid:days:usd:traffic_bytes, separados por vírgula; 0 bytes = ilimitado.
SNAPEX_PARTNER_IDOpcional: o Partner ID do integrador que configurou o módulo (programa de indicações da SnapEX Pay). Deixe em branco se você mesmo fez a configuração.

Perguntas

Quais versões do Remnawave são compatíveis?

Remnawave 2.2 ou mais recente.

Por que a assinatura do novo usuário está vazia?

Um usuário sem squad interno não tem inbounds. Coloque os UUIDs dos squads para novos usuários em REMNAWAVE_SQUADS; os usuários existentes mantêm os squads que já têm.

Como funcionam as renovações?

Um pagamento para um nome de usuário existente soma os dias do plano a partir de agora ou do vencimento atual do usuário, o que for mais tarde. O limite de tráfego passa a ser o do novo plano.

Um pagamento pode criar um usuário duas vezes?

Não. Mesmo que o mesmo webhook chegue duas vezes no mesmo instante, o usuário é provisionado uma única vez.

Existe um bot do Telegram pronto?

Sim, um bot do Telegram da SnapEX Pay à parte, para Marzban, 3x-ui e Remnawave. Este serviço é indicado quando você já tem seu próprio bot ou loja.

Outras integrações

WHMCS BILLmanager FOSSBilling Paymenter Blesta WooCommerce CS-Cart Xboard / V2Board Marzban 3x-ui Bot de VPN no Telegram n8n

Pronto para receber em cripto?

Crie uma conta de comerciante, gere uma chave de API e conecte o módulo. 1% por pagamento, sem mensalidade.