Pagamentos em cripto para Xboard e V2Board
Um plugin de pagamento para os painéis de VPN e proxy Xboard e V2Board. No checkout, o cliente vai para a página da SnapEX Pay, paga em USDT nas redes TRC20, ERC20 ou BEP20 (ou por outro método que a SnapEX oferece para esse valor), e o pedido é liberado automaticamente após um webhook assinado. Sem carteira, node ou gateway auto-hospedado para manter; o dinheiro entra no seu saldo de comerciante na SnapEX Pay.
Grátis. Versão 1.2.0.
O que faz
- Plugin nativo para Xboard (instalável pelo gerenciador de plugins do painel de administração), além de uma classe pronta para copiar,
app/Payments/SnapexPay.php, para o V2Board e versões antigas do Xboard. - Valores na unidade certa: os totais do painel em centavos são enviados como valor decimal em USD, com uma cotação opcional para lojas que não vendem em USD.
- Webhooks assinados (HMAC-SHA256, janela de 5 minutos); a fatura é relida na API da SnapEX Pay, e o pedido só é marcado como pago quando o status é paid.
- Um novo clique em Pay reaproveita a mesma fatura; se ela tiver expirado, uma nova é aberta para o mesmo pedido. Faturas de teste nunca liberam um pedido enquanto o método está em modo real.
- A janela de pagamento nunca passa do prazo de pedido do próprio painel (Xboard: 2 horas; V2Board: 30 minutos). PHP e cURL puros, sem dependências extras.
Instalação
- Xboard: administração → Plugins → envie o ZIP baixado → Install → Enable “SnapEX Pay”. (Ou descompacte e coloque a pasta no painel como
plugins/Snapexpay/— o nome diferencia maiúsculas de minúsculas — e depois instale em Plugins.) - V2Board ou Xboard antigo: copie
app/Payments/SnapexPay.phpdo arquivo compactado para o painel e reinicie o PHP-FPM ou o Octane se usar OPcache; no V2Board, confira se a Site URL (app_url) está preenchida. - Payment configuration → Add payment method → gateway SnapexPay. Cole a chave de API (escopos
invoices.read,invoices.write) do painel da SnapEX Pay. - Copie a notify URL que o painel mostra para esse método, defina-a como URL do webhook no painel da SnapEX Pay (Desenvolvedores) e cole a chave secreta
whsec_…(exibida uma única vez, ao salvar a URL pela primeira vez) em Webhook secret. - Se os preços não estiverem em USD, preencha “USD per 1 shop currency” (por exemplo,
0.14para CNY). Salve e teste um pagamento.
Configurações
| API key | No painel da SnapEX Pay → Desenvolvedores, escopos invoices.read e invoices.write. |
|---|---|
| Webhook secret | A chave secreta whsec_… do endpoint do webhook. Sem uma assinatura HMAC válida, nenhum pedido é marcado como pago. |
| Network fee paid by | merchant: o cliente paga exatamente o total do pedido, e a taxa é descontada do que você recebe. customer: a taxa da SnapEX Pay e a taxa de rede são somadas ao valor. |
| Payment window, minutes | Xboard: padrão 60 (máx. 120); V2Board: padrão 20 (máx. 30) — não mais que o prazo de pedido dos próprios painéis. |
| USD per 1 shop currency | 1 para preços em USD; por exemplo, 0.14 para CNY. |
| Partner ID | Opcional: 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
Funciona com o V2Board?
Sim. O Xboard tem um plugin nativo; o V2Board e as versões antigas do Xboard usam a classe pronta app/Payments/SnapexPay.php, com as mesmas configurações.
Meus preços estão em CNY ou em outra moeda.
Preencha “USD per 1 shop currency”: o valor é total / 100 × usd_rate, por exemplo, 0.14 para CNY.
E se o cliente clicar em Pay duas vezes?
A mesma fatura é reaproveitada; se ela tiver expirado, uma nova é aberta para o mesmo pedido.
Por que a janela de pagamento é limitada?
O Xboard cancela pedidos não pagos após 2 horas, e o V2Board após 30 minutos, por isso a janela fica dentro desse limite.
Por que preciso de HTTPS?
A SnapEX Pay só entrega webhooks para URLs HTTPS públicas, e o pedido é liberado pelo webhook.
Outras integrações
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.