Faturamento de hospedagem

Pagamentos cripto para WISECP

Aceite cripto nas faturas e pedidos do WISECP. O cliente escolhe SnapEX Pay — cripto (USDT e outras moedas), paga na página da SnapEX Pay em USDT na TRON, Ethereum, BSC e outras redes, ou em outras moedas convertidas em USDT, e a fatura é marcada como paga no WISECP automaticamente.

Baixar o módulo GitHub

Grátis. Versão 1.0.2.

O que faz

Sem carteiras nem nós para manter: o dinheiro cai no seu saldo de lojista na SnapEX Pay.
O pagamento é registrado pelo webhook assinado ou assim que o cliente volta da página de pagamento, o que acontecer primeiro. Nos dois casos a fatura é antes relida na API da SnapEX Pay: o corpo do webhook sozinho nunca marca nada como pago, e um pagamento nunca é registrado duas vezes.
Se o cliente voltar antes da confirmação, ele vê uma página de status que verifica a cada 10 segundos e segue sozinha para a página "pagamento realizado" do WISECP.
Pagamentos parciais são informados como pendentes, com o valor recebido na observação do pagamento, para você revisar antes de aprovar.
Modo de teste: faturas de teste se confirmam sozinhas, sem dinheiro real; enquanto ele está ativo, só um administrador logado vê o botão.
Sem tabelas extras no banco de dados: o módulo guarda seus dados no checkout do WISECP. Textos do painel em inglês, turco e russo.
Moedas: USDT (TRC20, ERC20, BEP20) em faturas de qualquer valor; BTC, ETH, LTC e TRX, também em faturas menores quando a taxa de rede permite; as outras moedas, em faturas a partir de US$ 8.

Instalação

Envie o conteúdo do arquivo para a pasta raiz do WISECP, mantendo o caminho coremio/modules/Payment/SnapexPay/.
No painel do WISECP abra as configurações de gateways de pagamento, encontre SnapEX Pay (Crypto) entre os módulos, ative-o e abra as configurações. No WISECP 5: Payment Gateways → adicione-o em Enabled Module Selection, salve e abra o cartão dele.
No painel de lojista da SnapEX Pay crie uma API key com as permissões invoices.read e invoices.write e cole-a em API key.
No painel adicione um webhook com a URL mostrada abaixo de Webhook secret (https://<seu WISECP>/payment/SnapexPay/<token>/callback no WISECP 3, …/payments/SnapexPay/<token>/callback no WISECP 5; copie-a da página de configurações) e cole o segredo whsec_… em Webhook secret. É pelo webhook que os pagamentos chegam quando o cliente não volta ao site.
Se suas faturas não estão em USD, mantenha o USD entre as moedas do WISECP com uma taxa de câmbio: o módulo converte o valor para USD com as taxas do WISECP. Se você configurar o gateway para converter para USD, o WISECP já repassa o valor em USD e não é preciso converter.
Ative o Test mode, continue logado no painel, abra uma fatura em aberto na área do cliente no mesmo navegador, pague-a com um método de teste na página da SnapEX Pay e confira se ela fica paga. Depois desative o modo de teste.

Configurações

API key	Do painel da SnapEX Pay.
Webhook secret	`whsec_…` das configurações do webhook no painel. A URL do webhook aparece abaixo do campo.
Network fee paid by	Merchant: o cliente paga exatamente o valor da fatura. Client: a taxa é somada ao valor.
Payment window, minutes	Por quanto tempo a página de pagamento vale (1–1440, padrão 60). Pagar mais tarde abre uma nova.
Test mode	Faturas de teste, só para administradores logados. Pagamentos de teste são ignorados depois que o modo é desativado.
Partner ID	Opcional: o Partner ID do integrador que configurou o módulo (programa de indicação da SnapEX Pay). Deixe vazio se você mesmo configurou.
API URL	Deixe como está.

Perguntas

Com quais versões do WISECP funciona?

Com o WISECP 3 e o WISECP 5. Foi verificado de ponta a ponta em uma instalação real do WISECP 5.0-beta.3: webhook, retorno do cliente e webhook atrasado depois do retorno — um pagamento em cada caso.

Por que adicionar o webhook?

Se o cliente paga e não volta ao site, é pelo webhook assinado que o pagamento chega ao WISECP. Quando o cliente volta, o pagamento é registrado na hora e nunca duas vezes.

Minhas faturas não estão em USD. Funciona?

Sim. Mantenha o USD entre as moedas do WISECP com uma taxa de câmbio, e o módulo converte o valor com as taxas do WISECP. Ou configure o gateway para converter para USD, e o WISECP repassa o valor em USD.

O que aparece no WISECP quando uma fatura é paga?

O pagamento é informado como bem-sucedido e o WISECP marca a fatura (ou o pedido) como paga. O ID da transação é o número da fatura da SnapEX Pay (INV-…), e a observação do pagamento diz com o que o cliente pagou.

E se o cliente enviar menos que o valor da fatura?

Se o cliente não completar a tempo, o pagamento é informado como pendente, com o valor recebido na observação. Revise-o antes de aprovar.

E se a página de pagamento expirar sem pagamento?

Nada é registrado, e o cliente pode pagar de novo. Se chegar dinheiro depois de a fatura ser fechada, o log de módulos do WISECP recebe um registro; o dinheiro fica no seu saldo da SnapEX Pay.

Onde vejo o que o módulo fez?

No log de módulos do WISECP: ali ficam os erros da API e cada pagamento registrado. A API key e o segredo do webhook nunca vão para o 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.