Pagamentos em cripto para WooCommerce
Receba cripto no WooCommerce. O cliente escolhe Crypto no checkout, 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 pedido vai para “Processando” 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.
- Funciona tanto com o bloco Checkout quanto com a página clássica
[woocommerce_checkout], e também com os links “Pagar pedido”. Compatível com HPOS (tabelas de pedidos próprias) e com o armazenamento de pedidos legado. - Três formas independentes de marcar um pedido como pago: o webhook assinado, o retorno do cliente da página de pagamento e uma verificação em segundo plano (o WP-Cron a executa a cada 5 minutos; cada pedido pendente é verificado de novo no máximo a cada 10 minutos, durante 5 dias). Um webhook perdido nunca deixa um pedido pago em aberto, e um pedido nunca é concluído duas vezes.
- O valor é sempre relido na API da SnapEX Pay; o corpo do webhook, sozinho, nunca marca nada como pago.
- Pagamentos parciais e pagamentos que chegam depois que o pedido foi cancelado colocam o pedido em “Aguardando” para revisão.
- Modo de teste: faturas de teste se confirmam sozinhas, sem dinheiro real; enquanto ele está ativo, só os gerentes da loja veem o método.
Instalação
- Painel do WordPress → Plugins → Add New → Upload Plugin →
snapex-pay-for-woocommerce-1.1.0.zip→ Activate. (Ou descompacte emwp-content/plugins/.) - Abra WooCommerce → Settings → Payments → SnapEX Pay (crypto).
- 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 (recomendado): no painel, defina a URL do webhook como
https://<your shop>/wc-api/snapexpay_webhook/(o endereço exato aparece abaixo do campo) e cole a chave secretawhsec_…em Webhook secret. - Loja com moeda diferente de USD: preencha “USD for 1 <currency>” ou use um plugin de moedas pelo filtro
snapexpay_wc_amount_usd. Sem uma dessas opções, o método fica oculto no checkout. - Ative o Test mode, faça um pedido como administrador, pague-o na página da SnapEX Pay com um método de teste e confira se ele vai para “Processando”. Depois, desative o modo de teste.
Configurações
| Title, Description | O que o cliente vê no checkout. |
|---|---|
| API key | Do painel da SnapEX Pay. |
| Webhook secret | A chave whsec_… das configurações de webhook do painel. Sem ela, os pedidos continuam sendo marcados como pagos quando o cliente volta e pela verificação em segundo plano. |
| 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 | Por quanto tempo a página de pagamento fica válida (1–1440, padrão 60). Usar “Pagar pedido” mais tarde abre uma página nova. |
| USD for 1 … | Só quando a moeda da loja não é USD: a cotação usada nas faturas da SnapEX Pay. |
| Test mode | Faturas de teste, só para os gerentes da loja. Pagamentos de teste nunca são aplicados depois que ele é 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. |
Perguntas
Quais moedas a loja pode usar?
As faturas da SnapEX Pay são em USD. Lojas em USD funcionam sem ajustes; para outras moedas, defina a cotação nas configurações ou converta com o filtro snapexpay_wc_amount_usd.
Funciona com o novo bloco Checkout?
Sim: com o bloco Checkout, com a página de checkout clássica e com os links “Pagar pedido”. É compatível com HPOS e com o armazenamento de pedidos legado.
O que acontece depois de um pagamento bem-sucedido?
O WooCommerce executa payment_complete(): o pedido vai para “Processando” (ou “Concluído”, no caso de produtos virtuais ou para download), o estoque é reduzido e os e-mails habituais são enviados. O ID da transação é o ID da fatura da SnapEX Pay.
E se o cliente enviar menos que o total do pedido?
Se o cliente não completar o pagamento a tempo, o pedido vai para “Aguardando” com uma nota para revisá-lo no painel da SnapEX Pay.
Posso fazer reembolsos pelo WooCommerce?
Não. Os reembolsos são feitos no painel da SnapEX Pay.
Quais dados o plugin envia?
Para criar uma fatura, ele envia o valor do pedido em USD, uma referência do pedido, o nome da loja e o número do pedido, os links de retorno e de cancelamento (eles contêm a chave do pedido), as configurações de pagamento e o Partner ID, se houver. Nome, e-mail, endereço e endereço IP do cliente não são enviados.
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.