Pagamentos em cripto para Blesta
Receba cripto nas faturas do Blesta. A SnapEX Pay é um gateway non-merchant: o cliente escolhe SnapEX Pay (Crypto), 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 é registrado no Blesta e aplicado às faturas automaticamente.
Grátis. Versão 1.0.0.
O que faz
- Sem carteiras nem nodes para manter: o dinheiro entra no seu saldo de comerciante na SnapEX Pay.
- O pagamento é registrado pelo webhook assinado ou assim que o cliente volta para a página de “pagamento recebido”, o que acontecer primeiro. Em ambos os 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.
- Qualquer moeda de fatura: valores que não estão em USD são convertidos para USD pelas cotações que o Blesta já mantém, e a transação é registrada na moeda da fatura.
- Pagamentos parciais nunca são aplicados automaticamente: viram uma transação pendente para você revisar.
- Modo de teste: faturas de teste se confirmam sozinhas, sem dinheiro real; enquanto ele está ativo, só membros da equipe logados como cliente veem o botão, e os demais clientes são orientados a escolher outra forma de pagamento.
Instalação
- Envie o conteúdo do arquivo compactado para a pasta raiz do Blesta, mantendo o caminho
components/gateways/nonmerchant/snapex_pay/. - No painel administrativo do Blesta, abra Settings → Payment Gateways → Available, encontre SnapEX Pay (Crypto) e clique em Install. A instalação cria uma tabela,
snapex_pay_invoices. - No painel do comerciante da SnapEX Pay, crie uma chave de API com os escopos
invoices.readeinvoices.writee cole-a no campo API key. - Webhook (obrigatório): no painel, adicione um webhook com a URL
https://<your Blesta>/callback/gw/<company id>/snapex_pay/(o endereço exato aparece nas configurações do gateway) e cole a chave secretawhsec_…em Webhook secret. O Blesta não tem cron para gateways, então é pelo webhook que os pagamentos chegam quando o cliente não volta ao site. - Se as suas faturas não estão em USD, adicione o USD em Settings → Company → Currencies com uma cotação (ou deixe o Blesta atualizar as cotações automaticamente). Marque as moedas para as quais o gateway deve ser oferecido.
- Ative o Test mode, entre na área do cliente como um cliente a partir do painel administrativo, pague uma fatura na página da SnapEX Pay com um método de teste e confira se a fatura foi paga. Depois, desative o modo de teste.
Configurações
| API key | Do painel da SnapEX Pay. Armazenada criptografada. |
|---|---|
| Webhook secret | A chave whsec_… das configurações de webhook do painel. Obrigatória. Armazenada criptografada. |
| 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 fica válida (1–1440, padrão 60). Pagar de novo mais tarde abre uma página nova. |
| Test mode | Faturas de teste; enquanto ele está ativo, só a equipe vê o botão. Pagamentos de teste são ignorados depois que o modo de teste é desativado. |
| 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. |
| API URL | Deixe como está. |
Perguntas
Por que o webhook é obrigatório?
O Blesta não tem cron para gateways. Se o cliente paga e não volta ao site, é pelo webhook assinado que o pagamento chega ao Blesta. Quando o cliente volta, o pagamento é registrado na hora, e ele nunca é registrado duas vezes.
Minhas faturas não estão em USD. Vai funcionar?
Sim. Adicione o USD em Settings → Company → Currencies com uma cotação. Os valores são convertidos pelas cotações do Blesta, e a transação é registrada na moeda da fatura.
O que aparece no Blesta quando uma fatura é paga?
Uma transação aprovada na moeda da fatura, aplicada às faturas que foram pagas. O ID da transação é o ID da fatura da SnapEX Pay (INV-…), e o cliente recebe o e-mail habitual de “pagamento recebido” do Blesta.
E se o cliente enviar menos que o valor da fatura?
Se o cliente não completar o pagamento a tempo, é registrada uma transação pendente, com o valor recebido na mensagem, e ela não é aplicada. Revise-a nas transações do cliente.
E se a página de pagamento expirar sem pagamento?
Nada é registrado. Se o dinheiro chegar depois que a fatura foi encerrada, o log do gateway recebe um registro; o dinheiro fica no seu saldo da SnapEX Pay.
Onde vejo o que o módulo fez?
No Blesta, em Tools → Logs → Gateway.
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.