Guides
WooCommerce
Un moyen de paiement pour WooCommerce : bitcoin et USDC/USDT directement sur votre portefeuille, commandes marquées payées par un webhook signé.
Le plugin Perly Pay ajoute la crypto à la page de commande classique et au bloc Checkout. Chaque commande devient une facture Perly Pay ; l’acheteur la paie par-dessus votre boutique ou sur sa propre page ; un webhook signé marque la commande comme payée. WordPress 6.5+, WooCommerce 8.6+, PHP 8.1+. Rien à installer sur le serveur : le SDK PHP est inclus.
Installation
- 1
Obtenez le zip
Le plugin est en route vers WordPress.org. D’ici là, écrivez-nous pour recevoir
perly-pay-woocommerce.zip. - 2
Installez
Dans WordPress : Extensions → Ajouter → Téléverser une extension, choisissez le zip, activez. WooCommerce doit être actif.
- 3
Ouvrez les réglages
WooCommerce → Réglages → Paiements → Perly Pay.
Réglages
| Réglage | Valeur |
|---|---|
| Secret key (clé secrète) | Depuis Dashboard → Developers → API keys. sk_test_… pour le mode test, sk_live_… pour l’argent réel. Les réglages indiquent dans quel mode vous êtes. |
| Webhook signing secret (secret de signature) | whsec_…. Set up webhook le remplit pour vous. |
| Payment page (page de paiement) | Overlay ouvre la caisse par-dessus votre boutique (pay.js). Redirect y envoie l’acheteur. Sur téléphone, c’est toujours la page elle-même. |
| Status when paid (statut une fois payé) | Celui de WooCommerce (En cours ; Terminée pour les téléchargements), toujours En cours, ou toujours Terminée. |
| Title, Description (titre, description) | Ce que les acheteurs voient au moment de payer. |
| Debug log (journal de débogage) | Événements et erreurs dans WooCommerce → État → Journaux. Jamais de clés, de secrets ni de données d’acheteurs. |
- 1
Collez la clé
Puis touchez Test connection : il indique si la clé marche, son mode, et si le webhook de cette boutique existe dans Perly Pay.
- 2
Configurez le webhook
Touchez Set up webhook. Il ajoute l’adresse de la boutique (affichée au-dessus des boutons,
…/wp-json/perly-pay/v1/webhook) dans Perly Pay et enregistre son secret. Ou ajoutez-la vous-même dans Developers → Webhooks et collez le secret. - 3
Autorisez l’overlay
Dans Dashboard → Settings, ajoutez l’adresse de la boutique à Sites that may embed the checkout. Sans cela, l’overlay propose d’ouvrir la caisse dans un nouvel onglet.
- 4
Activez
Cochez Take crypto with Perly Pay et enregistrez.
Test
Avec une clé sk_test_…, passez une commande dans votre boutique et choisissez Perly Pay. La commande attend en Attente paiement. Payez la facture avec des monnaies de test, ou depuis l’API — son id figure dans les notes de la commande :
En quelques secondes, la commande passe à En cours, avec une note indiquant le réseau, le montant et un lien vers la transaction. {"outcome":"short"} et {"outcome":"over"} testent les autres cas une fois une monnaie choisie sur la page de la facture.
Comment les commandes suivent les paiements
| Dans Perly Pay | La commande |
|---|---|
Payé et l’expéditeur contrôlé (invoice.fulfilled) | Payée : le statut choisi, le stock réduit, l’e-mail à l’acheteur. Une note par transfert, avec sa transaction. |
| Vu, payé en partie, payé mais encore en contrôle | Une note. Toujours en attente de paiement. |
| Retenu pour vérification | En attente, avec la raison. Décidez dans Perly Pay. |
| Expiré ou annulé, rien de payé | Annulée. |
| Expiré avec un paiement partiel | En attente : remboursez-le ou acceptez-le dans Perly Pay. |
| Remboursé | Remboursée en entier, ou une note pour un remboursement partiel. |
Chaque événement est appliqué une seule fois, à la commande pour laquelle il a été créé, et un « expiré » tardif n’annule jamais un paiement. Si l’acheteur revient sur la page de remerciement avant le webhook, le plugin interroge l’API et met la commande à jour aussitôt.
Remboursements
Remboursez depuis l’écran de la commande comme d’habitude : le plugin ouvre un remboursement dans Perly Pay, dans la monnaie payée (une partie pour un remboursement partiel). Perly Pay demande une adresse à l’acheteur par e-mail et la contrôle ; les notes de la commande indiquent ensuite quoi envoyer et où. Vous envoyez depuis votre portefeuille et collez l’id de transaction dans Perly Pay — Perly Pay ne détient jamais l’argent.
Passer en réel
- Activez le mode réel dans Perly Pay et connectez les clés publiques de votre portefeuille.
- Collez une clé
sk_live_…. Les clés et webhooks réels sont distincts de ceux de test : touchez à nouveau Set up webhook. - Ajoutez l’adresse https de votre boutique réelle à Sites that may embed the checkout en mode réel.
- Passez une petite commande réelle et remboursez-la.