O que o módulo faz
- O checkout mostra Cartão, Apple Pay, Google Pay, PayPal e Cripto (com seletor de moeda). Qualquer um pode ser desativado.
- O pedido é criado no status Awaiting UTOPAY payment e depois o comprador paga na página da UTOPAY.
- Quando o pagamento, relido pela API, confere em valor e moeda, o pedido vai para Payment accepted; o id do pagamento da UTOPAY é salvo como id da transação.
- A página de confirmação do pedido verifica o pagamento de novo e mostra Pagar novamente enquanto o pedido não estiver pago.
- Cripto paga a menos e valores divergentes são registrados em Advanced Parameters → Logs para o pedido.
Instalação
- Baixe o ZIP acima.
- Modules → Module Manager → Upload a module → escolha o ZIP (PrestaShop 1.6: Modules → Add a new module).
- Abra Configure. No painel da UTOPAY crie uma chave de teste
utopay_sk_test_…(Integration → API keys) e cole. A chave é verificada ao salvar. - Escolha as opções de pagamento e as moedas. Para cripto adicione sua carteira EVM no painel (Project settings → Funds & payouts).
- Confirme que o módulo está liberado para suas moedas e países em Payment → Preferences.
Configurações
| Campo | O que faz |
|---|---|
| Secret key | utopay_sk_test_… para o sandbox, utopay_sk_live_… para pagamentos reais. Deixe vazio para manter a chave salva. |
| Payment options | Cartão / PayPal e cripto, só cartão ou só cripto. |
| Crypto coins | Tickers separados por vírgula, ex. bep20/usdt,erc20/usdt,polygon/usdc. |
| Card method | Vazio: o comprador escolhe; ou direto para Stripe, PayPal, Revolut… |
Pagamento de teste
- Com a chave de teste faça um pedido e escolha uma opção da UTOPAY.
- No sandbox da UTOPAY clique no botão verde ✅.
- Você volta para a página de confirmação do pedido: «Pagamento recebido». No back office o pedido está em Payment accepted.
- Troque a chave por
utopay_sk_live_….
Como os pedidos são confirmados
Cada pagamento leva sua própria URL de notificação (/module/utopay/callback) com o id do pedido, o valor e a moeda, assinada com a sua chave secreta. A UTOPAY assina cada evento (HMAC-SHA256) e tenta de novo por seis horas se a loja não responder 2xx.
O módulo confere as duas assinaturas, relê o pagamento pela API e define Payment accepted só quando ele está pago exatamente com o total e a moeda do pedido.
Solução de problemas
- UTOPAY não aparece no checkout: a moeda do carrinho não é suportada, a chave está vazia ou o módulo não está liberado para a moeda / país em Payment → Preferences.
- Pedidos continuam em «Awaiting UTOPAY payment»: a loja precisa estar acessível pela internet e o modo de manutenção desligado; veja Advanced Parameters → Logs.
- «amount is below the minimum»: o total está abaixo do mínimo do método ou da moeda; o comprador pode clicar em Pagar novamente e escolher outro.
Histórico de versões
- 1.0.0 — primeira versão: PrestaShop 1.6.1 – 9, cartões e PayPal, cripto, Pagar novamente, tradução para o russo.
SHA-256: 3fbdc9540feaa15a12ca677af2c56d55284f104a119c50bc139fe20e1248ac52
Atualizado · Equipe de integrações da UTOPAY