VibeFox Stripe for WooCommerce — Aide

Prérequis

WordPress : 6.0 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

HTTPS : votre site doit utiliser HTTPS pour les paiements réels.

Compte Stripe : vous avez besoin des clés API secrètes de votre compte Stripe et d'un point de terminaison de webhook dans le Stripe Dashboard (voir Configuration). Seules les clés secrètes et les secrets de signature des webhooks sont utilisés. Les clés publiables (pk_...) ne sont pas nécessaires, car Stripe Checkout est une page hébergée par Stripe.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP du plugin et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_stripe_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Stripe > Manage, ou cliquez sur Settings sous le nom du plugin sur la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Collez vos clés secrètes Stripe, configurez le webhook dans le Stripe Dashboard et collez ses secrets de signature (voir Configuration).

6. Activez Enable/Disable. Testez un paiement en mode test avec la carte 4242 4242 4242 4242, puis décochez Test Mode.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Stripe. Au-dessus des champs, la page vous avertit lorsque le mode actuel n'a pas de clé secrète (le moyen de paiement est alors masqué au paiement) ou pas de secret de signature de webhook, et affiche Test mode is on: no real payments are taken. tant que le mode test est activé. Dans la liste des moyens de paiement, Stripe est signalé comme nécessitant une configuration tant que le mode actuel n'a pas de clé secrète.

Général

Enable/Disable : Enable Stripe Gateway active ou désactive le moyen de paiement. Par défaut : désactivé.

Title : le nom du moyen de paiement que voient les clients au moment du paiement. Par défaut : Stripe.

Description : le texte affiché sous le moyen de paiement au moment du paiement. Par défaut : Pay securely with your credit or debit card via Stripe.

Clés API

Copiez les clés secrètes depuis Stripe Dashboard > Developers > API keys. Les clés de test et les clés de production sont distinctes. Le mode test utilise uniquement les clés de test, le mode production uniquement les clés de production. Lors de l'enregistrement, l'extension vous avertit si une valeur ne commence pas par le préfixe attendu, par exemple si une clé publiable a été collée à la place d'une clé secrète.

Test Mode : Enable test mode utilise les clés de test de Stripe. Aucun argent réel n'est débité ; payez avec des cartes de test Stripe telles que 4242 4242 4242 4242. Par défaut : activé. Décochez-le pour accepter de vrais paiements.

Test Secret Key : la clé secrète du mode test. Elle commence par sk_test_ (ou rk_test_ pour une clé restreinte).

Test Webhook Secret : le secret de signature (whsec_...) du point de terminaison de webhook créé en mode test.

Live Secret Key : la clé secrète du mode production. Elle commence par sk_live_ (ou rk_live_ pour une clé restreinte).

Live Webhook Secret : le secret de signature (whsec_...) du point de terminaison de webhook créé en mode production.

Webhook

Le webhook indique à votre boutique qu'un paiement a été effectué. Dans Stripe Dashboard > Developers > Webhooks, ajoutez un point de terminaison en mode test et un autre en mode production. Utilisez l'URL affichée dans cette section des réglages. Elle ressemble à https://your-site/wc-api/strg_stripe_webhook/. Si votre site utilise un préfixe de langue dans les URL, copiez l'URL exactement telle que les réglages l'affichent, car Stripe ne suit pas les redirections.

Sélectionnez ces événements pour chaque point de terminaison :

Après avoir créé chaque point de terminaison, copiez son secret de signature (whsec_...) depuis Stripe et collez-le dans Test Webhook Secret ou Live Webhook Secret. Les webhooks sans signature valide sont rejetés. Sans webhook, une commande n'est confirmée que lorsque le client revient dans la boutique après avoir payé.

Commandes

Order Status After Payment : le statut de commande défini après un paiement réussi. Le statut est défini immédiatement, sans second changement de statut.

Avancé

Logging : Enable logging écrit les requêtes et les webhooks Stripe dans WooCommerce > Status > Logs, source wcp_stripe_gateway. Les clés et les données clients ne sont pas journalisées. Par défaut : désactivé.

Delete Data on Uninstall : lorsqu'elle est activée, la suppression du plugin supprime les réglages de la passerelle, les données Stripe stockées sur les commandes et les journaux. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut Stripe) et valide la commande. Le plugin crée une session Stripe Checkout pour le total de la commande dans la devise de la commande et envoie le client sur la page de paiement Stripe. Là, le client paie par carte de crédit ou de débit. L'adresse e-mail de facturation du client est transmise à Stripe, et le paiement apparaît sur la page Stripe sous Order # suivi du numéro de commande.

Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. La commande n'est marquée payée qu'après confirmation de Stripe : par le webhook signé ou par une requête côté serveur vers Stripe lorsque le client arrive sur cette page. Si le paiement n'est pas encore confirmé, la page affiche Your payment is being confirmed by Stripe. You will receive an e-mail as soon as it is confirmed.

Si le client annule sur la page Stripe, la commande est annulée de la façon standard de WooCommerce. Un client peut payer à nouveau une commande impayée, par exemple depuis la page Pay for order. Chaque nouvelle tentative ferme la session Stripe précédente, de sorte que la commande ne peut pas être payée deux fois.

Si Stripe ne peut pas démarrer le paiement, le client voit un court message, par exemple indiquant que le total de la commande est inférieur au montant minimum que Stripe peut débiter dans cette devise, et peut choisir un autre moyen de paiement. La raison technique est ajoutée aux notes de commande et au journal. Les gestionnaires de la boutique connectés la voient également dans le message.

Le moyen de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

Le plugin n'accepte que les paiements par carte, encaissés immédiatement sur la page Stripe. Il ne propose ni cartes enregistrées, ni abonnements ou paiements récurrents, ni formulaire de carte sur le site, ni boutons Apple Pay ou Google Pay sur votre site, ni autorisation et capture séparées.

Commandes et remboursements

Statuts de commande

Pending payment : le client a été envoyé vers Stripe et n'a pas encore payé, ou Stripe n'a pas encore confirmé le paiement.

Processing, Completed or On Hold : le paiement a été confirmé. Le statut suit Order Status After Payment. La note de commande indique le paiement Stripe et la manière dont il a été confirmé (webhook ou retour). L'ID de transaction est l'ID de paiement Stripe (pi_...) et, sur l'écran de la commande, il renvoie au paiement dans le Stripe Dashboard.

On hold after payment : Stripe a signalé un montant ou une devise différent du total de la commande (par exemple, la commande a été modifiée après le début du paiement), ou le paiement est arrivé après l'annulation de la commande. La note de commande l'explique. Vérifiez la commande et traitez-la, ou remboursez le paiement.

Failed : un paiement différé a échoué.

Cancelled : le client a annulé sur la page Stripe, ou la commande a été annulée par vous ou par le délai d'expiration de la réservation de stock de WooCommerce. La session Stripe ouverte de la commande est fermée, elle ne peut donc plus être payée.

Si un second paiement arrive pour une commande déjà payée, la commande n'est pas modifiée à nouveau. Une note vous invite à le vérifier et à rembourser le doublon dans le Stripe Dashboard.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Stripe. Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé dans le mode où le paiement a été effectué (test ou production), la clé secrète de ce mode doit donc être définie. Si Stripe n'accepte pas le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande avec l'ID de remboursement Stripe.

Les remboursements effectués dans le Stripe Dashboard arrivent par le webhook charge.refunded et sont ajoutés aux notes de commande. Ils ne sont pas enregistrés automatiquement comme remboursements WooCommerce. Si nécessaire, créez un remboursement manuel dans WooCommerce sans utiliser Refund via Stripe.

Clé de licence

Le plugin fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > Stripe. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active et votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, Stripe n'est pas proposé aux clients au moment du paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Les gestionnaires de la boutique connectés voient toujours le moyen de paiement, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester le plugin avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés, et les remboursements fonctionnent.

Lorsqu'une licence expire, le plugin continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Stripe n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode actuel a une clé secrète : Test Secret Key en mode test, Live Secret Key en mode production. La page des réglages affiche un avertissement lorsque la clé est absente.

Le paiement a abouti, mais la commande reste Pending payment : le webhook ne fonctionne pas. Dans le Stripe Dashboard, vérifiez que le point de terminaison existe dans le mode utilisé (test ou production), que son URL est exactement celle affichée dans les réglages et que les quatre événements sont sélectionnés. Vérifiez que le secret de signature de ce point de terminaison se trouve dans le champ correspondant (Test Webhook Secret ou Live Webhook Secret). Le Stripe Dashboard affiche la réponse de votre boutique pour chaque webhook. La commande est aussi confirmée lorsque le client revient dans la boutique après avoir payé.

Le webhook répond Webhook secret not configured : aucun des deux secrets de webhook n'est défini. Collez le secret de signature dans les réglages.

Le webhook répond Invalid signature : le secret de signature appartient à un autre point de terminaison ou à un autre mode, ou l'horloge du serveur est incorrecte. Les signatures Stripe sont acceptées dans un délai de 5 minutes par rapport à l'heure du serveur.

Le webhook répond Busy, retry : la commande était en cours de confirmation par une autre requête au même moment. Stripe relance automatiquement le webhook.

Avertissement à l'enregistrement : la valeur ne semble pas correcte : une clé a été collée dans le mauvais champ. Les clés secrètes commencent par sk_test_ / rk_test_ ou sk_live_ / rk_live_, les secrets de webhook par whsec_.

Le client voit une erreur lors de la validation de la commande : ouvrez les notes de commande ou activez Logging et consultez WooCommerce > Status > Logs, source wcp_stripe_gateway. Une clé incorrecte ou absente affiche le message indiquant que le moyen de paiement n'est pas correctement configuré. Un total de commande inférieur au minimum Stripe pour la devise (par exemple 0,50 EUR) ne peut pas être payé avec Stripe.

Les paiements de test ne confirment pas une commande réelle : les paiements de test et les paiements réels sont séparés. Un paiement de test ne confirme jamais une commande réelle, et inversement. Réglez Test Mode sur le mode souhaité et utilisez les clés et le webhook de ce mode.

La commande est On hold after payment : lisez la note de commande. Le montant ou la devise payé(e) était différent(e) de la commande, ou le paiement est arrivé après l'annulation de la commande. Traitez la commande ou remboursez le paiement.

Le remboursement échoue avec un message concernant le mode : le paiement a été effectué en mode test ou production, et la clé secrète de ce mode n'est pas définie. Saisissez-la et réessayez.

Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà 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é pour le nouveau domaine. Si le serveur de licences est injoignable, le plugin continue de fonctionner avec le dernier statut connu.

Désinstallation

La désactivation du plugin conserve toutes les données. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et le statut de licence de ce plugin sont toujours supprimés. Les réglages de la passerelle, les données Stripe stockées sur les commandes et les journaux ne sont supprimés que si Delete Data on Uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement et leurs ID de transaction.

Stripe est une marque de commerce de son propriétaire respectif. Ce plugin n'est ni affilié à Stripe ni approuvé par Stripe.