VibeFox SimplePay for WooCommerce — Aide

Prérequis

WordPress : 6.0 ou ultérieur.

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

PHP : 8.0 ou ultérieur.

Devise de la boutique : HUF, EUR ou USD. SimplePay n'accepte pas d'autres devises, et le mode de paiement n'est pas proposé pour elles.

Comptes marchands SimplePay : SimplePay fournit un compte marchand distinct pour chaque devise, et des comptes séparés pour la production et le sandbox. Pour chaque compte, il vous faut son MERCHANT et sa SECRET KEY, disponibles dans l'interface marchand de SimplePay (admin.simplepay.hu pour la production, sandbox.simplepay.hu pour le sandbox), compte > Données techniques. Si vous ne vendez qu'en HUF, le compte HUF suffit. Aucune autre clé n'est nécessaire.

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 de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_simplepay_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > SimplePay (OTP) > Manage, ou cliquez sur Settings sous le nom de l'extension 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. Saisissez le MERCHANT et la SECRET KEY de vos comptes SimplePay pour chaque devise que vous vendez : comptes sandbox pour les tests et comptes de production pour les paiements réels (voir Configuration).

6. Copiez l'IPN URL affichée sur la page des réglages dans chaque compte marchand (production et sandbox) de l'interface SimplePay.

7. Activez Enable/Disable, testez un paiement avec Sandbox mode activé, puis décochez Sandbox mode pour encaisser de vrais paiements.

Lors de la mise à jour depuis la version 1.0, le Merchant ID et la Secret key uniques de la 1.0 sont transférés vers le compte de la devise de la boutique, dans le mode actif à ce moment (sandbox ou production). Vérifiez les comptes après la mise à jour.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > SimplePay (OTP). Au-dessus des champs, la page vous avertit lorsque la devise de la boutique n'est pas prise en charge par SimplePay, ou lorsqu'elle n'a pas de compte marchand dans le mode actuel. Dans les deux cas, le mode de paiement n'est pas proposé pour les commandes dans cette devise. Tant que le mode sandbox est activé, la page affiche Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. Dans la liste des modes de paiement, SimplePay est signalé comme nécessitant une configuration tant que le mode actuel ne compte pas au moins un compte marchand.

Général

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

Title : le nom du mode de paiement que voient les clients sur la page de paiement. Par défaut : SimplePay (Card Payment).

Description : le texte affiché sous le mode de paiement sur la page de paiement. Par défaut : Pay securely with your credit or debit card via SimplePay. Les marchands hongrois doivent afficher sur la page de paiement la déclaration de transfert de données de SimplePay (Adattovábbítási nyilatkozat). Vous pouvez la mettre ici, avec son lien.

Sandbox mode : Use the SimplePay sandbox envoie les paiements vers le sandbox SimplePay et utilise les comptes sandbox. Cela change à la fois l'adresse de l'API et les comptes marchands. Aucun argent réel n'est débité. Par défaut : activé. Décochez pour encaisser de vrais paiements avec les comptes de production.

Comptes marchands de production

Les comptes utilisés lorsque Sandbox mode est désactivé. Renseignez les comptes des devises dans lesquelles votre boutique vend. Les valeurs de MERCHANT et SECRET KEY se trouvent dans l'interface marchand de SimplePay (admin.simplepay.hu), compte > Données techniques. Un compte n'est utilisé que si ses deux champs sont renseignés.

HUF account — Merchant ID : le MERCHANT de votre compte de production HUF.

HUF account — Secret key : la SECRET KEY de votre compte de production HUF.

EUR account — Merchant ID et EUR account — Secret key : idem pour votre compte de production EUR.

USD account — Merchant ID et USD account — Secret key : idem pour votre compte de production USD.

Comptes marchands sandbox

Les comptes utilisés lorsque Sandbox mode est activé. Les champs sont les mêmes que pour les comptes de production : HUF account — Merchant ID, HUF account — Secret key, et les mêmes paires pour EUR et USD. Récupérez les valeurs dans l'interface marchand sandbox de SimplePay (sandbox.simplepay.hu), compte > Données techniques.

IPN URL

L'IPN est le message que SimplePay envoie à votre boutique lorsque le statut du paiement change. C'est la voie normale par laquelle une commande est marquée comme payée. La page des réglages affiche l'IPN URL de votre boutique. Elle ressemble à https://your-site/wc-api/simplepay_payment_callback/. Renseignez cette URL dans chaque compte marchand, de production et sandbox, dans l'interface SimplePay. Si votre site utilise un préfixe de langue dans les URL ou redirige d'autres adresses, copiez l'URL exactement telle qu'affichée dans les réglages, car un IPN redirigé est perdu.

L'IPN doit être signé avec la SECRET KEY du compte marchand qu'il désigne. Les IPN sans signature valide sont rejetés. Le plugin confirme chaque IPN valide à SimplePay sous la forme signée qu'exige SimplePay. Ces statuts d'IPN modifient la commande :

FINISHED : le paiement a réussi. La commande est marquée payée après le contrôle du montant et de la devise.

NOTAUTHORIZED, FRAUD : le paiement a été refusé. La commande passe en Échec.

TIMEOUT, CANCELLED : le délai de paiement a expiré ou le client a annulé. La commande passe en Annulée.

Les statuts Échec et Annulée ne sont appliqués qu'à la dernière tentative de paiement d'une commande encore En attente de paiement. Les autres statuts sont journalisés et ne modifient pas la commande. Sans IPN, une commande n'est confirmée que lorsque le client revient sur la boutique après un paiement réussi.

Commandes

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

WooCommerce default (Processing; Completed for virtual/downloadable orders) : la valeur par défaut.

Completed : chaque commande payée passe en Terminée.

Avancé

Logging : Enable logging écrit les appels API, les IPN et les retours dans WooCommerce > Status > Logs, source wcp_simplepay_gateway. Les clés et les données clients ne sont pas journalisées. Les erreurs sont toujours journalisées, même lorsque cette option est désactivée. Par défaut : désactivé.

Delete Data on Uninstall : Remove all plugin data when uninstalling. Lorsqu'elle est activée, la suppression de l'extension efface les réglages de la passerelle et les journaux de l'extension. Les données de commande sont toujours conservées. Par défaut : désactivé.

Paiement

Le client choisit le mode de paiement (par défaut SimplePay (Card Payment)) et passe la commande. Le plugin lance un paiement par carte SimplePay pour le total de la commande dans la devise de la commande, avec le compte marchand de cette devise dans le mode actuel, puis envoie le client sur la page de paiement SimplePay. La page affiche ce que votre compte marchand autorise pour les paiements par carte. L'adresse e-mail du client et, lorsqu'elle est complète, l'adresse de facturation sont transmises à SimplePay. La page de paiement utilise la langue de votre site lorsque SimplePay la prend en charge, sinon l'anglais. Un paiement lancé peut être effectué dans les 30 minutes.

Après un paiement réussi, le client revient sur la page de commande reçue de votre boutique. Le retour seul ne paie jamais une commande : le plugin demande à SimplePay le statut de la transaction par une requête signée, de sorte que la commande est confirmée même si l'IPN arrive en retard. La page de commande reçue affiche Successful transaction. SimplePay transaction ID: et l'identifiant. Si le paiement n'est pas encore confirmé, elle affiche Your payment is being confirmed by SimplePay. SimplePay transaction ID: et l'identifiant.

Si le paiement échoue, est annulé ou expire, le client est renvoyé vers le paiement, ou vers la page Pay for order lorsque le panier est vide. Il y voit le message de SimplePay avec l'identifiant de transaction, par exemple Cancelled payment. You cancelled the payment ou Timeout. The time allowed to complete the payment has expired. En cas d'échec, le client est invité à vérifier les données saisies et à contacter sa banque émettrice de carte. Le client peut réessayer. Chaque nouvelle tentative reçoit sa propre référence SimplePay, par exemple 123, 123-2, 123-3.

Si SimplePay ne peut pas lancer le paiement, le client voit The SimplePay payment could not be started. Please try again or choose another payment method. Si la devise de la commande n'a pas de compte marchand, le message est SimplePay is not available for the currency of this order. Please choose another payment method. La raison technique est ajoutée aux notes de commande et au journal. Les gestionnaires connectés de la boutique la voient aussi dans le message.

Le mode 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).

L'extension ne prend que des paiements par carte uniques, encaissés sur la page SimplePay. Elle ne gère ni cartes enregistrées ni paiements en un clic, ni abonnements ou paiements récurrents, ni autorisation et capture séparées.

Commandes et remboursements

Statuts de commande

Pending payment : le client a été envoyé vers SimplePay et n'a pas encore payé, ou SimplePay n'a pas encore confirmé le paiement. La note de commande affiche la transaction lancée, le montant et le mode (sandbox ou production).

Processing or Completed : le paiement est confirmé. Le statut suit Order Status After Payment. La note de commande affiche l'identifiant de transaction et indique si l'IPN ou la demande de statut a confirmé le paiement. L'identifiant de transaction SimplePay est enregistré comme identifiant de transaction de la commande. Un paiement réussi tardif valide aussi une commande passée en Échec ou en Annulée.

On hold : le total ou la devise de la commande a été modifié après le lancement du paiement, donc le montant payé diffère de la commande. La note de commande affiche les deux montants. Vérifiez la commande et traitez-la, ou remboursez le paiement.

Failed : SimplePay a signalé que la dernière tentative de paiement n'était pas autorisée ou était frauduleuse.

Cancelled : SimplePay a signalé que la dernière tentative de paiement a expiré ou a été annulée.

Une commande remboursée ou terminée n'est jamais rouverte par un IPN tardif. Si un second paiement réussit pour une commande déjà payée, la commande n'est pas modifiée à nouveau. Une note vous demande de le vérifier dans l'interface SimplePay et de le rembourser s'il s'agit d'un doublon.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via SimplePay (OTP). Les remboursements totaux et partiels sont pris en charge. Les remboursements en HUF doivent être en montants entiers de forints. Le remboursement est envoyé avec le compte marchand et dans le mode (sandbox ou production) utilisés pour le paiement, donc ce compte doit toujours figurer dans les réglages. Si SimplePay 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'identifiant de transaction de remboursement SimplePay et le motif, si vous en avez saisi un.

Les remboursements effectués dans l'interface marchand de SimplePay ne sont pas synchronisés avec WooCommerce. Enregistrez-les manuellement dans WooCommerce, sans utiliser Refund via SimplePay (OTP).

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 > SimplePay (OTP). 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, SimplePay n'est pas affiché aux clients sur la page de 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 connectés voient toujours le mode de paiement, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension 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 le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

SimplePay n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que la devise de la commande est HUF, EUR ou USD, et que cette devise a à la fois un Merchant ID et une Secret key dans le mode actuel : les comptes sandbox tant que Sandbox mode est activé, les comptes de production tant qu'il est désactivé. La page des réglages affiche un avertissement lorsque la devise de la boutique n'a pas de compte.

Le paiement a abouti, mais la commande reste En attente de paiement : l'IPN n'a pas atteint la boutique. Dans l'interface marchand de SimplePay, vérifiez l'IPN URL du compte marchand utilisé (production ou sandbox, devise de la commande). Elle doit correspondre exactement à l'URL affichée dans les réglages, et votre serveur doit être joignable depuis Internet. La commande est aussi confirmée lorsque le client revient sur la boutique après le paiement.

L'IPN répond Invalid signature : l'IPN désigne un compte marchand absent des réglages, ou sa Secret key est incorrecte. Saisissez le MERCHANT et la SECRET KEY exactement tels qu'ils apparaissent dans l'interface marchand de SimplePay. SimplePay renvoie les IPN non confirmés.

L'IPN répond Order not found ou Unknown transaction : l'IPN concerne une commande ou une transaction que cette boutique n'a pas lancée. La commande n'est pas modifiée.

L'IPN répond Busy, retry : la commande était en cours de confirmation par une autre requête au même moment. SimplePay renvoie l'IPN.

Le client voit une erreur lors de la passation de commande : ouvrez les notes de commande ou consultez WooCommerce > Status > Logs, source wcp_simplepay_gateway. Une mauvaise secret key donne Invalid response signature from SimplePay. Check the secret key of the merchant account. Les erreurs SimplePay s'affichent sous la forme SimplePay error code(s) : suivie des codes.

Après un changement entre sandbox et production : les nouveaux paiements utilisent les comptes du nouveau mode. Les commandes lancées auparavant conservent le compte marchand et le mode avec lesquels elles ont été lancées : leurs IPN, demandes de statut et remboursements utilisent ce compte. Gardez les comptes de l'ancien mode dans les réglages tant que ces commandes sont ouvertes ou peuvent être remboursées.

La commande est En attente après le paiement : lisez la note de commande. Le total ou la devise de la commande a été modifié après le lancement du paiement. Traitez la commande ou remboursez le paiement.

Le remboursement échoue : lisez le message. SimplePay refunds in HUF must be whole amounts. signifie que le montant en HUF comportait des décimales. Si le message indique que le compte marchand de ce paiement n'est pas configuré, saisissez à nouveau le compte (devise et mode) avec lequel le paiement a été effectué. Si SimplePay a remboursé un montant différent, le message vous demande de vérifier le remboursement dans l'interface SimplePay.

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

Désactiver l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours supprimés. Les réglages de la passerelle et les journaux de l'extension 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, identifiants de transaction et données SimplePay.

SimplePay est une marque déposée de son propriétaire respectif. Cette extension n'est ni affiliée à SimplePay ni approuvée par SimplePay.