Pagamentos em cripto para BILLmanager
Receba cripto no BILLmanager. O cliente escolhe SnapEX Pay (crypto) ao adicionar saldo ou pagar um pedido, paga na página da SnapEX Pay em USDT nas redes TRON, Ethereum, BSC e outras, ou em outras moedas convertidas para USDT, e o pagamento é creditado no BILLmanager automaticamente.
Grátis. Versão 1.1.0.
O que faz
- Sem carteiras nem nodes para manter: o dinheiro entra no seu saldo de comerciante na SnapEX Pay.
- Três formas independentes de creditar um pagamento: o webhook assinado, o retorno do cliente da página de pagamento e a verificação periódica (
checkpay). Um webhook perdido nunca deixa um pagamento feito sem crédito, e um pagamento nunca é creditado duas vezes. - O valor é sempre relido na API da SnapEX Pay; o corpo do webhook, sozinho, nunca credita nada.
- Pagamentos parciais não são creditados automaticamente: o log pede que você os revise.
- Modo de teste: faturas de teste se confirmam sozinhas, sem dinheiro real, e nunca são creditadas depois que o modo de teste é desativado.
Instalação
- No servidor do BILLmanager, como root:
tar xzf snapexpay-billmanager-1.1.0.tar.gz,cd snapexpay-billmanager-1.1.0,sh install.sh. O script copia o módulo para/usr/local/mgr5, adiciona um cron decheckpaya cada 5 minutos (/etc/cron.d/snapexpay) como garantia extra e reinicia o BILLmanager. - No painel do comerciante da SnapEX Pay, crie uma chave de API com os escopos
invoices.readeinvoices.write. - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto). Moeda: USD. Cole a chave de API; ao salvar, ela é verificada na SnapEX Pay.
- Webhook (recomendado): no painel, defina a URL do webhook como
https://<your billing domain>/mancgi/snapexpayresulte cole a chave secretawhsec_…em Webhook secret. - Clientes que pagam em outras moedas: o BILLmanager converte o valor para a moeda da forma de pagamento (USD) pelas próprias cotações, então mantenha a cotação do USD atualizada.
- Teste primeiro: uma forma de pagamento separada com o Test mode ativado, disponível só para um cliente de teste (Payment methods → restrições por grupo de clientes). Depois, desative o modo de teste ou exclua essa forma de pagamento.
Configurações
| API key | Do painel da SnapEX Pay. |
|---|---|
| Webhook secret | A chave whsec_… das configurações de webhook do painel. Sem ela, os pagamentos continuam sendo creditados quando o cliente volta e pela verificação periódica. |
| Client pays the network fee | Desligado: o cliente paga exatamente o valor do pagamento, e a taxa é descontada do que você recebe. Ligado: a taxa da SnapEX Pay e a taxa de rede são somadas ao valor. |
| Payment window, minutes | Por quanto tempo a página de pagamento da SnapEX fica válida (1–1440, padrão 60). Se o pagamento for aberto de novo mais tarde, uma nova página é criada. |
| Test mode | Faturas de teste sem dinheiro real. Pagamentos de teste nunca são creditados depois que essa opção é desativada. |
| API URL | Deixe em branco. |
| 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
Quais edições do BILLmanager são compatíveis?
BILLmanager 6, qualquer edição. O módulo precisa só de python3 3.6+ com a biblioteca padrão no servidor do BILLmanager.
O que acontece se o webhook não chegar?
O pagamento é creditado mesmo assim quando o cliente volta da página de pagamento ou pela verificação periódica, que roda a cada 5 minutos. Um pagamento nunca é creditado duas vezes.
Meus clientes pagam em rublos ou outras moedas. Vai funcionar?
Sim. A forma de pagamento é em USD, e o BILLmanager converte o valor pelas próprias cotações; mantenha a cotação do USD atualizada.
E se o cliente enviar menos que o necessário?
Se o cliente não completar o pagamento a tempo, nada é creditado, e o log mostra “closed with a PARTIAL payment (…) - review in SnapEX Pay and credit manually”.
E se o cliente não pagar a tempo?
O pagamento fica com o status “In payment” para que o cliente possa tentar de novo; um dia depois que a última fatura da SnapEX expira, ele é cancelado.
Como removo o módulo?
Execute sh install.sh --uninstall. O histórico de pagamentos fica em var/snapexpay.sqlite. Tudo o que o módulo faz é registrado em /usr/local/mgr5/var/pmsnapexpay.log.
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.