VibeFox Peach Payments for WooCommerce — Aide
Prérequis
WordPress: 6.2 ou ultérieur.
WooCommerce: 8.0 ou ultérieur, installé et actif. Sans lui, l'extension refuse de s'activer.
PHP: 8.0 ou ultérieur.
Currency: la devise de la boutique doit être ZAR, KES ou MUR. Dans les autres devises, le moyen de paiement est masqué et la page des réglages le signale.
Peach Payments account: vous avez besoin des identifiants Card API de votre compte Peach Payments : Entity ID et Access Token. Les identifiants de test proviennent du tableau de bord sandbox Peach Payments, ceux de production du tableau de bord Peach Payments ; ils sont différents. Pour les webhooks, il faut aussi une clé de déchiffrement que Peach Payments vous envoie à l'activation des webhooks Card pour votre boutique (voir Configuration). Votre site doit être accessible depuis Internet pour recevoir les webhooks.
VibeFox license key: achetée sur vibefox.net. Une clé fonctionne sur un domaine.
Installation
1. Dans WordPress, ouvrez Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_peach_pay dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Peach Payments > Manage, ou cliquez sur Settings sous le nom de l'extension sur la page des extensions.
4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
5. Saisissez les Entity ID et Access Token de test du tableau de bord sandbox Peach Payments et demandez à Peach Payments d'activer les webhooks Card pour l'URL indiquée dans les réglages (voir Configuration).
6. Activez Enable/Disable et enregistrez. Laissez Test mode activé et effectuez un paiement avec une carte de test de la sandbox Peach Payments. Décochez ensuite Test mode, saisissez les identifiants et la clé de webhook de production, puis enregistrez.
Les réglages de la version 1.0 sont transférés automatiquement dans les nouveaux champs après la mise à jour.
Configuration
Tous les réglages sont sur une page : WooCommerce > Settings > Payments > Peach Payments. Au-dessus des champs figurent des avis : Test mode is on: payments go to the Peach Payments sandbox and no real money is charged. ; un avis si l'Entity ID ou l'Access Token du mode actuel manque (le moyen de paiement reste alors absent de la page de paiement) ; un avis si la clé de déchiffrement des webhooks du mode actuel manque (les paiements ne sont alors confirmés qu'au retour du client) ; et un avis si la devise n'est pas prise en charge. Dans la liste des moyens de paiement, Peach Payments est signalé comme nécessitant une configuration tant que le mode actuel n'a pas d'Entity ID et d'Access Token. À l'enregistrement, les espaces sont retirés des identifiants et une erreur est signalée si la clé de webhook n'est pas une valeur hexadécimale de 64 caractères.
Enable/Disable: Enable Peach Payments active ou désactive le moyen de paiement. Par défaut : désactivé.
Title: le nom du moyen de paiement affiché au client sur la page de paiement. Par défaut : Credit / Debit Card (Peach Payments).
Description: le texte affiché sous le moyen de paiement. Par défaut : Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.
Identifiants API
L'Access Token et l'Entity ID de la Card API figurent dans le tableau de bord Peach Payments (identifiants de test : tableau de bord sandbox). Cette section contient des liens vers les deux tableaux de bord et la documentation développeur Peach Payments.
Test mode: Enable test mode envoie les nouveaux paiements vers la sandbox Peach Payments avec les identifiants de test, sans débit réel. Décochez cette option pour accepter des paiements réels avec les identifiants de production. Un paiement commencé dans un mode est toujours vérifié dans ce mode, même après un changement. Par défaut : activé.
Test Entity ID: l'Entity ID (canal 3-D Secure) de votre compte sandbox.
Test Access Token: le jeton d'accès bearer de votre compte sandbox.
Test Webhook Decryption Key: la clé hexadécimale de 64 caractères servant à déchiffrer les webhooks Card de la sandbox.
Live Entity ID: l'Entity ID (canal 3-D Secure) de votre compte de production.
Live Access Token: le jeton d'accès bearer de votre compte de production.
Live Webhook Decryption Key: la clé hexadécimale de 64 caractères servant à déchiffrer les webhooks Card du compte de production.
Webhook
Les webhooks confirment les paiements même si le client ferme le navigateur avant de revenir. Cette section affiche l'URL de webhook de votre boutique, de la forme https://your-site/wp-json/peach-pay/v1/webhook. Copiez-la exactement comme indiquée dans les réglages. Demandez à Peach Payments (support@peachpayments.com) d'activer les webhooks Card pour votre compte avec cette URL, puis saisissez la clé de déchiffrement reçue dans le champ Webhook Decryption Key du même mode.
Peach Payments chiffre chaque webhook (AES-256-GCM). Un webhook impossible à déchiffrer avec la clé de test ou de production est rejeté ; seul Peach Payments peut donc modifier vos commandes. Un webhook déchiffré avec la clé d'un mode s'applique uniquement aux paiements commencés dans ce mode. L'extension utilise les notifications de paiement :
Les autres notifications, par exemple celle de test envoyée à l'activation du webhook, reçoivent une réponse OK et sont ignorées. Sans clé de webhook, une commande n'est confirmée qu'au retour du client après le paiement.
Formulaire de paiement
Card brands: les marques affichées dans le formulaire Peach Payments : Visa, Mastercard, American Express, Diners Club. Sélectionnez uniquement celles activées pour votre Entity ID. Par défaut : Visa et Mastercard.
Avancé
Logging: Log API requests and payment results écrit les informations de débogage dans WooCommerce > Status > Logs, source wcp_peach_pay. Les erreurs et avertissements sont toujours consignés. Les journaux ne contiennent ni données de carte, ni clés, ni données clients. Par défaut : désactivé.
Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Désactiver l'extension ne supprime jamais rien. Les données Peach Payments des commandes sont conservées. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut Credit / Debit Card (Peach Payments)) et clique sur Continue to payment. Il arrive sur la page Pay for order de votre boutique. L'extension y prépare un paiement Peach Payments pour le total et dans la devise de la commande, puis affiche le formulaire de carte Peach Payments avec les marques choisies, dans la langue du site si Peach Payments la prend en charge. En mode test, la page affiche Test mode: use a Peach Payments test card, no real payment will be made.. Les données de carte sont saisies dans le formulaire Peach Payments et son script est chargé avec une empreinte Subresource Integrity.
Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'après confirmation de Peach Payments : la boutique lit le résultat du paiement de cette commande via l'API Peach Payments, dans le mode où il a été créé, et vérifie son appartenance à la commande. Le webhook fait la même chose indépendamment : le premier arrivé applique le résultat et le second ne modifie rien. Le client ayant payé voit la page Order received.
Si le paiement n'est pas terminé, le client revient sur la page Pay for order avec un message et peut réessayer : Payment failed: suivi du motif de Peach Payments et de Please try again or use another card., ou The payment was not completed. Please try again.. Si le résultat ne peut pas encore être confirmé (par exemple, Peach Payments n'a pas répondu ou le webhook traite la même commande), le message est We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again.. Si aucune clé de webhook n'est définie pour ce mode, le client est plutôt invité à vous contacter avec le numéro de commande.
Si le formulaire ne peut pas être préparé, le client voit un court message et un bouton Try again : The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (identifiants incorrects), un message indiquant que certaines coordonnées de facturation ont été refusées par le prestataire de paiement, ou The payment form could not be loaded. Please try again in a moment.. Une note avec le code et la description Peach Payments est ajoutée à la commande.
Le moyen de paiement fonctionne sur le paiement classique, le bloc Paiement et la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
L'extension ne propose ni formulaire de carte sur la page de paiement elle-même, ni cartes enregistrées, abonnements, préautorisation et capture, ni EFT, BNPL, QR ou autres moyens sans carte.
Commandes
États des commandes
Pending payment: le client n'a pas encore payé ou le paiement n'est pas terminé. Il peut repayer la même commande.
Processing: le paiement est confirmé et son montant et sa devise correspondent à la commande. La note affiche le code de résultat, la description et l'identifiant de paiement Peach Payments ; celui-ci est l'identifiant de transaction de la commande. Si Peach Payments a signalé une vérification manuelle, la note vous demande de contrôler le paiement dans le tableau de bord Peach Payments avant l'expédition.
On hold: le paiement attend une confirmation de Peach Payments (le webhook le termine plus tard ou le marque comme échoué) ; le montant ou la devise diffère de la commande (note amount/currency mismatch — manual review required) ; ou le paiement est arrivé après l'annulation de la commande. La note explique les points à vérifier.
Failed: Peach Payments a refusé le paiement d'une commande en attente de paiement ou le paiement qu'attendait une commande En attente. Une tentative refusée ne modifie jamais une commande payée, en attente pour un autre motif ou annulée. Le client peut repayer.
Si un second paiement d'une commande déjà payée réussit, la commande ne change pas. Une note indique le doublon et vous demande de le rembourser dans le tableau de bord Peach Payments. Un paiement reçu pour une commande remboursée donne seulement lieu à une note.
Remboursements
Les remboursements depuis l'écran de commande WooCommerce ne sont pas disponibles. Remboursez dans le tableau de bord Peach Payments et enregistrez un remboursement manuel dans WooCommerce. Avec le webhook configuré, les remboursements, annulations et rétrofacturations de Peach Payments sont ajoutés sous forme de notes avec montant et identifiant ; l'état de la commande ne change pas.
Clé de licence
L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence est en haut de WooCommerce > Settings > Payments > Peach Payments. Collez la clé dans License key et cliquez sur Activate. Le bloc indique l'état, par exemple la date de validité et votre domaine. Utilisez Check now pour revérifier l'état, Change key pour saisir une autre clé et Remove key pour la retirer du site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.
Une clé fonctionne sur un domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.
Sans clé active, Peach Payments n'apparaît pas aux clients sur la page de paiement. Si un paiement est néanmoins lancé, le client voit This payment method is not available. Please choose another one.. Les responsables de boutique connectés voient toujours le moyen de paiement, marqué (unlicensed — visible to admins only), pour vous permettre de configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page des extensions et les pages WooCommerce. Les commandes existantes restent intactes : les paiements déjà commencés sont toujours confirmés au retour du client et par webhook.
À l'expiration d'une licence, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. L'état est automatiquement revérifié en arrière-plan.
Dépannage
Peach Payments n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que les Entity ID et Access Token du mode actuel sont saisis (Test Entity ID et Test Access Token en test, Live Entity ID et Live Access Token en production) et que la devise est ZAR, KES ou MUR. Les avis en haut des réglages indiquent le problème. Les développeurs peuvent modifier les devises avec le filtre peach_p_supported_currencies ; ajoutez uniquement celles traitées par votre compte Peach Payments.
Le paiement a réussi, mais la commande reste Pending payment : le client n'est pas revenu et le webhook n'est pas arrivé. Vérifiez que Peach Payments a activé les webhooks Card pour l'URL exacte des réglages, que la Webhook Decryption Key du mode utilisé est saisie et qu'aucun mode maintenance, pare-feu ou mot de passe ne bloque l'URL. Cherchez les webhooks rejetés dans WooCommerce > Status > Logs, source wcp_peach_pay.
Le webhook répond Decryption failed : il n'a pu être déchiffré avec les clés de test ou de production. La clé est incorrecte ou appartient à un autre compte ou mode. Saisissez celle envoyée par Peach Payments pour cette URL.
Le webhook répond Webhook key not configured : aucune clé de webhook n'est définie ou valide. Saisissez la clé de 64 caractères. Peach Payments renverra le webhook plus tard.
Le webhook répond Order busy, retry later : la commande était simultanément mise à jour au retour du client. Rien n'a changé et Peach Payments renvoie le webhook.
Le webhook répond Missing or malformed data : la requête n'avait pas de corps chiffré ou les en-têtes X-Initialization-Vector / X-Authentication-Tag manquaient, par exemple à cause d'un proxy. Rien n'a changé.
Le webhook répond ignored : la notification est authentique, mais ne correspond pas à un paiement de cette boutique (autre boutique avec le même Entity ID, commande supprimée), ou provient d'un autre mode que le paiement. Rien n'a changé.
Le client voit The payment form is not available right now : l'Access Token ou l'Entity ID du mode actuel est incorrect. Vérifiez les identifiants et le mode, et consultez le code Peach Payments dans la note de commande.
La commande est On hold après paiement : lisez la note. Le montant ou la devise différait, le paiement est arrivé après l'annulation ou Peach Payments attend encore sa confirmation. Vérifiez le paiement dans le tableau de bord Peach Payments, puis traitez la commande ou remboursez.
L'enregistrement demande une clé de webhook hexadécimale de 64 caractères : la valeur n'est pas la clé fournie par Peach Payments. Les webhooks ne pourront pas être déchiffrés avant correction.
Le bloc de licence affiche une erreur : suivez son message. Si la clé est utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net et cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé sur le nouveau domaine. Si le serveur de licences est inaccessible, l'extension conserve le dernier état connu.
Désinstallation
La désactivation conserve toutes les données. Pour supprimer l'extension, désactivez-la puis supprimez-la sur la page Plugins. Sa clé et son état de licence sont toujours supprimés. Ses réglages et journaux (fichiers et entrées de journal en base de données de la source wcp_peach_pay) ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils restent pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement, identifiants de transaction et données de paiement Peach Payments.
Peach Payments est une marque commerciale de son propriétaire respectif. Cette extension n'est ni affiliée à Peach Payments ni approuvée par cette société.