USDT et USDC sur WordPress : configurer WooCommerce et EDD
Un paiement en stablecoins doit mettre à jour les commandes natives. UUGate propose des plugins WooCommerce et Easy Digital Downloads (EDD). Choisissez celui de votre plateforme : un simple bouton ne synchronise pas les commandes.
Vérifier l'environnement
Les plugins exigent PHP 8.1+, cURL, HTTPS et un stockage persistant. Suivez les instructions d'installation. Des commandes et callbacks ont été vérifiés dans des environnements précis ; vos versions, réseaux, boutique publique et mode de paiement restent à tester. Le parcours complet Checkout Blocks n'est pas universellement validé.
Protéger configuration et fichiers
Placez config.example.php hors du répertoire public et renseignez merchant_uid, api_key et un asset pris en charge. Faites pointer UUGATE_CONFIG_FILE vers ce fichier et state_dir vers un répertoire persistant accessible à PHP, jamais temporaire ou public. Utilisez un store_id distinct par boutique et environnement. Sauvegardez base et fichiers de commandes.
Activer le moyen de paiement
- WooCommerce : téléversez et activez le ZIP, puis UUGate dans Réglages → Paiements. Le callback utilise
?wc-api=uugate. - EDD : activez son plugin et UUGate dans les réglages. Le récepteur est
?edd-listener=uugate. - Sélectionnez TRC20-USDT, BEP20-USDT, BEP20-USDC ou SPL-USDC et vérifiez le réseau.
Une boutique en USD doit accepter explicitement usd_at_par=true. C'est une politique d'équivalence du marchand, pas un cours en temps réel ni une conversion fiduciaire. Les autres devises fiduciaires sont rejetées.
Vérifier la commande native
Le retour du navigateur ne doit pas débloquer produits ou téléchargements. Le plugin vérifie notification, commande et montant avant de modifier le paiement. Testez un paiement puis le même callback répété : un seul enregistrement doit exister. Une commande impayée ne doit pas donner accès au contenu payant. Voir le protocole.
Reprise et limites
Après création incertaine ou écriture interrompue, rapprochez plateforme et boutique selon le guide. Ne recréez pas de paiements et ne rejouez pas aveuglément une opération partiellement appliquée. Les plugins ne fournissent ni remboursement automatique ni prélèvement récurrent ; EDD ne prend pas en charge les abonnements récurrents. Pour un parcours personnalisé, utilisez PHP / Laravel et les réseaux USDT et USDC.
Paiements USDT avec WHMCS : adaptateur de test et factures
WHMCS utilise l’adaptateur 0.1.0 de test pour les liens de factures impayées ; ce n’est pas un plugin WordPress. La compatibilité complète entre versions n’est pas testée et le prélèvement automatique de renouvellement n’est pas pris en charge. Voir l’installation et l’accès au paquet de test.
Activez UUGate dans les passerelles WHMCS puis configurez identifiants côté serveur et stockage persistant. Le callback /modules/gateways/callback/uugate.php est généré depuis l’URL du système.
Le callback contrôle le solde impayé actuel. Paiement partiel, annulation ou changement de passerelle pendant le paiement exigent un contrôle manuel. Testez lien, paiement, notifications répétées et modifications de facture ; une simulation ne vérifie pas la compatibilité en production.