O que o pacote faz
- Cria o namespace utopay e as configurações de sistema utopay_* (chave, moeda, taxa, moeda cripto…), com descrições em inglês e russo.
- Com miniShop2: registra as classes de pagamento e cria dois métodos de pagamento desativados — «Card, Apple Pay, Google Pay, PayPal» (classe Utopay) e «Crypto: USDT, USDC» (classe UtopayCrypto).
- Com miniShop3 (MODX 3): cria os mesmos dois métodos com o provedor
Utopay\MiniShop3\UtopayPayment, que trabalha com as tentativas de pagamento do miniShop3 e sua rota de webhooks. - Depois do pedido, o comprador vai para a página da UTOPAY; o pedido só fica pago quando o pagamento, relido pela API, confere em valor e moeda.
- As atualizações mantêm suas configurações; ao desinstalar, os métodos são desativados e os pedidos ficam intactos.
Instalação
- Baixe o pacote acima (não renomeie
utopay-1.1.0-pl.transport.zip). - Manager do MODX → Extras → Installer → seta ao lado de «Download Extras» → Upload a package → escolha o arquivo → Install.
- System → System Settings → namespace utopay: defina utopay_secret_key — crie uma chave de teste
utopay_sk_test_…no painel da UTOPAY (Integration → API keys). Ajuste a moeda e a taxa se seus preços não estiverem em USD. - miniShop2 / miniShop3 → Settings → Payments: ative «Card, Apple Pay, Google Pay, PayPal» e/ou «Crypto: USDT, USDC» e vincule-os aos seus métodos de entrega.
- Para cripto adicione sua carteira EVM no painel (Project settings → Funds & payouts) e defina utopay_coin.
- Faça um pedido de teste e clique no botão verde ✅ no sandbox da UTOPAY — o pedido fica pago. Troque a chave por
utopay_sk_live_….
Configurações
| Configuração de sistema | O que faz |
|---|---|
| utopay_secret_key | utopay_sk_test_… / utopay_sk_live_…. |
| utopay_currency, utopay_rate | Moeda cobrada pela UTOPAY e taxa fixa a partir dos seus preços (1 se eles já estiverem nela). |
| utopay_shop_currency | Só miniShop3: moeda dos preços; as tentativas de pagamento são guardadas nela. |
| utopay_coin | Moeda do método cripto, ex. bep20/usdt. |
| utopay_provider | Opcional: enviar os compradores direto para Stripe, PayPal, Revolut… |
| utopay_ms2_paid_status, utopay_success_id | Status de pago do miniShop2 (2) e o recurso para onde o comprador volta. |
Como os pedidos são confirmados
Cada pagamento leva sua própria URL de notificação 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.
O pagamento é sempre relido pela API da UTOPAY; só um valor e uma moeda exatos marcam o pedido como pago. Cripto paga a menos e divergências vão para o log de erros do MODX com o prefixo [UTOPAY].
Histórico de versões
- 1.1.0-pl — pacote de instalação para o instalador do MODX: namespace, configurações de sistema, métodos de pagamento criados automaticamente.
- 1.0.0 — primeira versão em arquivos: miniShop2 (MODX 2.8 – 3.x) e miniShop3 1.14 beta.
SHA-256: 4c3b62e6f9d3dab65ad40b9610b463f40b78327eff0ec5aaabed77fac64a3a2a
Atualizado · Equipe de integrações da UTOPAY