USDT e USDC no WordPress: configuração do WooCommerce e EDD
O pagamento com stablecoins deve atualizar o fluxo nativo da loja. A UUGate oferece plugins WooCommerce e Easy Digital Downloads (EDD). Escolha o plugin da sua plataforma; um botão de pagamento sozinho não sincroniza pedidos.
Conferir o ambiente
São necessários PHP 8.1+, cURL, HTTPS e armazenamento persistente. Siga as instruções de instalação. Pedidos nativos e callbacks foram validados em ambientes específicos. Suas versões, redes, loja pública e checkout precisam de testes; o fluxo completo de Checkout Blocks não foi validado universalmente.
Proteger configuração e arquivos
Copie config.example.php para fora do diretório público e configure merchant_uid, api_key e um asset suportado. Aponte UUGATE_CONFIG_FILE para esse arquivo e state_dir para um diretório persistente gravável pelo PHP, nunca temporário nem de uploads públicos. Use store_id diferente por loja e ambiente. Faça backup do banco e do diretório de pedidos.
Ativar a forma de pagamento
- WooCommerce: envie e ative o ZIP; habilite UUGate em Configurações → Pagamentos. O callback usa
?wc-api=uugate. - EDD: ative seu plugin e UUGate nas configurações de pagamento. O receptor usa
?edd-listener=uugate. - Escolha TRC20-USDT, BEP20-USDT, BEP20-USDC ou SPL-USDC e confira a rede exibida.
Lojas em USD precisam aceitar explicitamente usd_at_par=true. É uma política de equivalência do comerciante, não cotação em tempo real nem conversão fiduciária. Outras moedas fiduciárias são rejeitadas.
Validar a conclusão nativa
O retorno do navegador não pode liberar produtos ou downloads. O plugin verifica callback, pedido e valor antes de atualizar o pagamento. Teste um pagamento normal e a notificação repetida: deve haver um único registro. Pedidos não pagos não podem acessar conteúdo pago. Veja o protocolo de callback.
Recuperação e limites
Após criação incerta ou escrita interrompida, concilie plataforma e loja conforme o guia antes de agir. Não recrie pagamentos nem repita operações parcialmente aplicadas sem verificar os efeitos. Os plugins não fornecem reembolso automático ou débito recorrente; EDD não suporta assinaturas recorrentes. Fluxos próprios podem usar PHP / Laravel, respeitando as redes USDT e USDC.
WHMCS com USDT: adaptador de teste e conferência de faturas
WHMCS usa o adaptador 0.1.0 de teste para links de faturas pendentes; não é plugin WordPress. Compatibilidade completa entre versões não foi testada e débito automático de renovação não é suportado. Veja instalação e acesso ao pacote de teste.
Ative UUGate nas interfaces de pagamento WHMCS e configure credenciais no servidor e armazenamento persistente. O callback /modules/gateways/callback/uugate.php é gerado a partir da URL do sistema.
O callback confere o saldo pendente atual. Pagamento parcial, cancelamento ou mudança de gateway durante o pagamento exigem revisão manual. Valide link, pagamento, avisos repetidos e alteração de fatura; simulação não comprova compatibilidade em produção.