Pagamentos em cripto para CS-Cart
Receba cripto no CS-Cart. 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 Processed 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.
- CS-Cart e CS-Cart Multi-Vendor: no Multi-Vendor, um pedido com vários vendedores é pago uma única vez; o add-on dá baixa no pedido principal, e o CS-Cart repassa o status para os pedidos dos vendedores.
- Quatro formas independentes de dar baixa em um pedido: o webhook assinado, o retorno do cliente da página de pagamento, uma verificação opcional por cron (cada pagamento pendente no máximo a cada 10 minutos, durante 5 dias) e a abertura do pedido por um administrador. Um webhook perdido nunca deixa um pedido pago em aberto, e um pagamento nunca é aplicado duas vezes.
- O valor é sempre relido na API da SnapEX Pay; o corpo do webhook, sozinho, nunca altera um pedido.
- Modo de teste: faturas de teste se confirmam sozinhas, sem dinheiro real.
Instalação
- Add-ons → Manage add-ons → + (Upload & install add-on) →
snapexpay-cscart-1.1.0.zip. (Ou copieapp/,design/,var/para a raiz da loja e instale o SnapEX Pay pela lista.) - Administration → Payment methods → + → processador SnapEX Pay (crypto), template
cc_outside.tpl, nome, por exemplo, “Crypto (USDT and other coins)”. - Na aba Configure, cole uma chave de API do painel do comerciante da SnapEX Pay (escopos
invoices.readeinvoices.write). - Webhook (recomendado): no painel, defina a URL do webhook mostrada abaixo de Webhook secret (
https://<store>/index.php?dispatch=payment_notification.webhook&payment=snapexpay) e cole a chave secretawhsec_…. - Opcional: adicione ao crontab do servidor a linha de cron mostrada abaixo de Payment check.
- Teste: ative o Test mode, limite o método a um grupo de usuários de teste, faça um pedido, pague-o na página da SnapEX Pay com um método de teste e confira se ele vai para Processed. Depois, desative o modo de teste.
Configurações
| API key | Do painel da SnapEX Pay. |
|---|---|
| Webhook secret | A chave whsec_… das configurações de webhook do painel. Sem ela, os pedidos continuam recebendo baixa quando o cliente volta, pela verificação por cron e quando um administrador abre o pedido. |
| 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). Pagar de novo mais tarde abre uma página nova. |
| Test mode | Faturas de teste. 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
Funciona com o CS-Cart Multi-Vendor?
Sim. Um pedido com vários vendedores é pago uma única vez: o add-on dá baixa no pedido principal, e o CS-Cart repassa o status para os pedidos dos vendedores.
A moeda da minha loja não é USD. Vai funcionar?
Sim, se o USD estiver entre as moedas da loja (pode ser secundária). O total do pedido é convertido pela cotação do USD da própria loja (Administration → Currencies), então mantenha essa cotação atualizada.
Quais status de pedido o add-on define?
Incomplete até o cliente voltar, Open enquanto o pagamento é confirmado, Processed quando o pagamento é feito por completo. Pedidos Open expirados e não pagos passam para Failed; os Incomplete continuam assim para que o cliente possa pagar de novo.
E se o cliente enviar menos que o total do pedido?
Se o cliente não completar o pagamento a tempo, a SnapEX Pay encerra a fatura como parcialmente paga, e o pedido passa para Open com uma nota para revisar o pagamento no painel da SnapEX Pay e concluir o pedido manualmente.
Posso fazer reembolsos pelo CS-Cart?
Não. Os reembolsos são feitos no painel da SnapEX Pay.
O que acontece se eu desinstalar o add-on?
As formas de pagamento que usam a SnapEX Pay são desativadas e as configurações da SnapEX Pay nelas são apagadas; a tabela de histórico de pagamentos (snapexpay_invoices) é mantida para uma futura reinstalação.
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.