VibeFox DPO for WooCommerce — Aide
Prérequis
WordPress : 6.2 ou ultérieur.
WooCommerce : 8.0 ou ultérieur, installé et actif. L'extension refuse de s'activer sans WooCommerce.
PHP : 8.0 ou ultérieur.
Compte DPO Pay : vous avez besoin du Company Token et du Service Type ID de votre compte marchand DPO. DPO les délivre à l'ouverture de votre compte ; obtenez-les auprès de votre gestionnaire de compte DPO ou sur dpogroup.com. DPO peut aussi fournir un compte de test avec son propre token et son propre service type. Il n'y a pas de serveur de test distinct : DPO utilise la même adresse API pour les comptes de test et de production, et le compte est choisi selon le token.
Devise : la devise de la boutique doit être prise en charge par votre compte DPO, par exemple USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF ou AED. DPO accepte au maximum 2 décimales, donc les totaux de commande avec 3 décimales (par exemple KWD 12.345) ne peuvent pas être payés.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un 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_dpo_pay dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > DPO Pay > Manage, ou cliquez sur Settings sous le nom de l'extension dans 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 le Company Token et le Service Type de test et/ou de production (voir Configuration).
6. Envoyez l'URL de notification push affichée sur la page des réglages au support DPO et demandez-leur de la configurer pour votre compte.
7. Activez Enable/Disable. Passez une commande de test en mode test, puis décochez Test mode pour accepter les paiements réels.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > DPO Pay. Lorsque la passerelle est activée mais que le Company Token ou le Service Type du mode sélectionné est vide, la page avertit que le moyen de paiement est masqué au paiement, et l'enregistrement affiche la même erreur. Tant que le mode test est activé, la page affiche Test mode is on: payments are created with the test account credentials.
Général
Enable/Disable : Enable DPO Pay 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 paiement. Par défaut : DPO Pay.
Description : le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely by card or mobile money on the DPO Pay payment page.
Identifiants API
DPO délivre un Company Token et un Service Type ID pour votre compte marchand, et des identifiants distincts pour un compte de test. Obtenez-les auprès de votre gestionnaire de compte DPO ou sur dpogroup.com.
Test mode : Use the test account credentials below. Lorsqu'il est activé, les nouveaux paiements sont créés avec le Company Token et le Service Type de test. Par défaut : activé. Décochez-le pour accepter les paiements réels avec les identifiants de production. Les vérifications de statut des commandes existantes utilisent toujours le compte avec lequel le paiement a été créé.
Test Company Token : le Company Token de votre compte de test DPO.
Test Service Type : le Service Type ID numérique de votre compte de test DPO.
Live Company Token : le Company Token de votre compte marchand DPO de production.
Live Service Type : le Service Type ID numérique de votre compte marchand DPO de production.
Un Service Type doit être un nombre. Toute autre valeur n'est pas enregistrée : la page affiche une erreur et conserve la valeur précédente. Si vous mettez à jour depuis la version 1.0, les identifiants de cette version sont aussi copiés dans les champs de test.
Notifications de paiement
La notification push informe immédiatement votre boutique qu'un paiement a été effectué, même si le client ferme le navigateur après avoir payé. Cette section affiche l'URL de notification push. Elle ressemble à https://your-site/wc-api/dpo_pay_notify/. Elle ne se configure pas dans un tableau de bord : demandez au support DPO de définir cette URL pour votre compte.
Les notifications push de DPO ne portent aucune signature, leur contenu n'est donc jamais considéré comme fiable. L'extension les utilise seulement pour trouver la commande, puis vérifie le paiement directement auprès de DPO. Sans l'URL push, les commandes sont tout de même confirmées lorsque le client revient à la boutique et par les vérifications automatiques 15 minutes après la redirection et après le délai de paiement.
Commandes
Successful payment status : le statut de la commande après un paiement réussi vérifié. Le statut est appliqué immédiatement, sans second changement de statut.
Avancé
Logging : Enable logging écrit les appels API et les notifications dans WooCommerce > Status > Logs, source wcp_dpo_pay. Les erreurs sont toujours journalisées. Les jetons sont masqués, aucune donnée client n'est journalisée. Par défaut : désactivé.
Delete data : Delete all plugin data when the plugin is deleted. Supprime les réglages, les données DPO enregistrées sur les commandes et les journaux lors de la désinstallation. La désactivation ne supprime jamais les données. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut DPO Pay) et passe la commande. L'extension crée une transaction DPO pour le montant total de la commande dans la devise de la commande, avec le numéro de commande et le nom de votre site comme description, et envoie le client vers la page de paiement DPO. Le nom, l'e-mail, le téléphone et l'adresse du client sont transmis pour préremplir la page. Là, le client paie avec toute méthode activée sur votre compte DPO. Le lien de paiement est valide 5 heures.
Après le paiement, le client revient à votre boutique. La commande n'est marquée payée qu'après confirmation de DPO : l'extension interroge DPO sur le résultat de la transaction lorsque le client revient, lorsqu'une notification push arrive et lors des vérifications automatiques. Une fois le paiement confirmé, le client accède à la page de commande reçue.
Si le paiement n'est pas confirmé, le client retourne au paiement ou à la page Pay for order avec l'un de ces messages :
Si le client clique sur le bouton de la page DPO pour revenir à la boutique, la commande est annulée de la manière standard de WooCommerce et son lien de paiement DPO est annulé chez DPO.
Lorsqu'un client paie à nouveau pour la même commande, le lien de paiement DPO précédent est d'abord vérifié. S'il a été payé, la commande est finalisée sans second débit. S'il est encore en cours de traitement, le client voit Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. Sinon, l'ancien lien est annulé chez DPO et un nouveau est créé.
Si DPO ne peut pas lancer le paiement, le client voit un court message choisi selon le code d'erreur DPO, par exemple que DPO Pay ne prend pas en charge la devise de cette commande, ou que le montant dépasse la limite autorisée par DPO Pay, et peut choisir un autre moyen de paiement.
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).
L'extension n'accepte que les paiements uniques sur la page DPO. Elle ne gère ni remboursements depuis WooCommerce, ni cartes enregistrées, abonnements ou paiements récurrents, champs de carte sur votre site, ni capture des paiements seulement autorisés.
Commandes
Statuts de commande
Pending payment : le client a été envoyé vers DPO et n'a pas encore payé, ou DPO n'a pas encore confirmé le paiement.
Processing, Completed ou On hold : le paiement a été vérifié. Le statut suit Successful payment status. La note de commande affiche le montant, la devise, le code d'approbation et le début du jeton de transaction DPO. L'ID de transaction est le jeton de transaction DPO.
On hold after payment : DPO a confirmé un paiement, mais le montant ou la devise diffère de la commande, le paiement est seulement autorisé et non capturé, la transaction a été sur- ou sous-payée, ou la commande avait déjà été annulée. La note de commande explique la raison. Vérifiez la transaction dans le portail DPO. Capturez ou annulez un paiement seulement autorisé dans le portail DPO, puis mettez à jour la commande.
Failed : le paiement a été refusé, annulé ou le délai de paiement est dépassé. Le client peut payer à nouveau.
Cancelled : le client est revenu à la boutique depuis la page DPO, ou la commande a été annulée par vous ou par le délai WooCommerce pour les commandes impayées. Le lien de paiement DPO non payé est annulé chez DPO.
Un message de refus ultérieur ne modifie jamais une commande déjà payée, et les résultats d'anciens liens de paiement ne font jamais échouer la tentative en cours. Si DPO confirme un second paiement réussi pour une commande déjà payée, la commande reçoit une note sur un possible double paiement, afin que vous puissiez le rembourser dans le portail DPO.
Remboursements
Les remboursements depuis WooCommerce ne sont pas disponibles dans cette version. Remboursez le paiement dans le portail marchand DPO, puis marquez la commande comme remboursée dans WooCommerce.
Clé de licence
L'extension fonctionne avec une clé de licence VibeFox provenant de vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > DPO Pay. 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 revérifier 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 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, DPO Pay n'est pas affiché aux clients au 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 boutique connectés voient toujours le moyen 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 des extensions et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés.
Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est revérifié automatiquement en arrière-plan.
Dépannage
DPO Pay n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le Company Token et le Service Type du mode sélectionné sont définis : les champs de test en mode test, les champs de production sinon. La page des réglages affiche un avertissement lorsqu'ils manquent.
Le paiement a été effectué, mais la commande reste à Pending payment : l'URL de notification push n'est probablement pas définie pour votre compte DPO, et le client n'est pas revenu à la boutique. Demandez au support DPO de définir l'URL indiquée dans les réglages. La commande est également confirmée par la vérification automatique 15 minutes après la redirection. Activez Logging et consultez WooCommerce > Status > Logs, source wcp_dpo_pay.
La notification push répond Unknown transaction : le jeton de transaction n'appartient pas à une commande DPO Pay de cette boutique, par exemple la notification provient d'une autre boutique sur le même compte DPO.
La notification push répond Verification failed : DPO n'a pas pu être contacté pour vérifier le paiement. DPO répète la notification, et la vérification automatique confirme aussi la commande.
Le Service Type n'est pas enregistré : il doit être le Service Type ID numérique fourni par DPO.
Le client voit DPO Pay is temporarily unavailable : DPO a refusé de créer la transaction, par exemple en raison d'un Company Token ou Service Type incorrect, ou d'un jeton de l'autre mode. Le code de résultat DPO se trouve dans WooCommerce > Status > Logs, source wcp_dpo_pay.
Le client voit que DPO accepte au maximum 2 décimales : le total de la commande comporte 3 décimales. DPO ne peut pas débiter de tels montants.
La commande est On hold après le paiement : lisez la note de commande. Le montant ou la devise payés différaient de la commande, le paiement est seulement autorisé, la transaction a été sur- ou sous-payée, ou la commande avait été annulée. Vérifiez la transaction dans le portail DPO.
Le bloc de licence affiche une erreur : suivez le message du 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 licence ne peut pas être contacté, l'extension continue de fonctionner avec le dernier statut connu.
Désinstallation
Désactiver l'extension conserve toutes les données et arrête seulement les vérifications de statut planifié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, les données DPO enregistrées sur les commandes, les vérifications planifiées et les journaux sont supprimés uniquement si Delete data était activé. Sinon, ils restent pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement et leurs ID de transaction.
DPO Pay est une marque de son propriétaire respectif. Cette extension n'est ni affiliée ni approuvée par DPO Pay.