Des stablecoins dans ta page de paiement BTCPay.

Installer

1. Télécharge BTCPayServer.Plugins.WhollyCrypto.btcpay et vérifie-le avec le fichier de la version SHA256SUMS. Utilise le fichier de l'extension, pas le ZIP des sources GitHub.
2. En tant qu'administrateur BTCPay, ouvre Gérer les extensions → Téléverser une extension, téléverse le fichier et redémarre BTCPay.
3. Sélectionne un magasin → Extensions → Wholly Crypto. L'installation seule ne connecte pas de magasin.

Les mises à jour utilisent le même téléversement. Mettre à jour le logiciel commerçant Wholly ne met pas à jour l'extension BTCPay.

Connecter un magasin

1. Dans Wholly, crée un projet et un magasin activés avec des moyens acceptés, des portefeuilles sauvegardés, des taux et des confirmations. Utilise une installation commerçant à jour ; ce connecteur cible l'API 6.4.5.
2. Copie les UUID du projet et du magasin depuis Magasin → Général → Identifiants API. Crée un identifiant API en lecture/écriture limité au projet. Active Magasin → IPN et copie son secret de signature, pas un secret de webhook.
3. Dans les réglages Wholly de BTCPay, saisis ces valeurs ainsi que tes origines API et paiement, par exemple https://api.example.com et https://pay.example.com. Utilise HTTPS public sur le port 443, sans chemins.
4. Active Proposer Wholly Crypto au paiement, enregistre, puis Tester l'accès en lecture. Tu peux choisir un sous-ensemble des moyens acceptés par le magasin.

Autorise les callbacks HTTPS de ton serveur Wholly vers BTCPay à travers les deux pare-feu. L'extension fournit l'URL de callback. N'applique pas de connexion navigateur, CAPTCHA ni Basic Auth à cette route ; la vérification des signatures doit rester activée.

Page de paiement intégrée

Le paiement en pleine page est le réglage par défaut, particulièrement utile pour les applications de portefeuille mobiles. Pour un iframe :

1. Dans Wholly, dans Magasin → Avancé, active Autoriser la page de paiement intégrée. Ajoute l'origine HTTPS exacte de ton BTCPay dans Origines HTTPS autorisées, sans chemin ni caractère générique.
2. Dans les réglages de l'extension BTCPay, choisis Paiement client → Page de paiement intégrée (iframe) et enregistre.
3. Teste une nouvelle facture. Les factures existantes conservent leur mode d'affichage d'origine. Ouvrir la page de paiement complète reste disponible pour la même facture si le cadre ne peut pas se charger.

Les messages du navigateur et les liens de retour servent à la navigation ; ils ne prouvent jamais le paiement.

Vérifier le parcours de paiement

Crée une petite facture fiat positive dans un magasin de test. Sélectionne Stablecoins et crypto · Wholly. Vérifie la page de paiement, l'IPN signé et la vérification API jusqu'à confirmation. Exécute uniquement à partir de la facture réglée dans BTCPay, une fois par commande.

Tester l'accès en lecture ne teste pas la création de factures ni l'IPN. Utilise Connexion et Paiements liés pour les erreurs sans données sensibles, les références de commande et les vérifications de paiement.