VibeFox 2C2P for WooCommerce — Aide

Prérequis

WordPress: 5.8 ou ultérieur.

WooCommerce: 6.0 ou ultérieur, installé et activé. Sans WooCommerce, l'extension affiche un avertissement dans l'administration et le moyen de paiement n'est pas chargé.

PHP: 8.0 ou ultérieur.

Compte 2C2P : vous avez besoin de l'identifiant marchand (Merchant ID) et de la clé secrète (Secret Key) de votre compte marchand 2C2P. 2C2P les délivre à l'ouverture de votre compte marchand. Les comptes de test (sandbox) et de production ont des clés différentes. La documentation pour développeurs et les cartes de test sandbox se trouvent sur developer.2c2p.com.

Devise : la devise de la boutique doit être prise en charge par l'extension et activée sur votre compte 2C2P. Sont notamment prises en charge : THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR et GBP. Si la devise de la boutique n'est pas prise en charge, le moyen de paiement est masqué au paiement.

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 téléverser le dossier wcp_2c2p_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > 2C2P > Manage, ou cliquez sur Settings sous le nom de l'extension sur la page Extensions.

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

5. Saisissez l'identifiant marchand et la clé secrète de votre environnement de test (sandbox), activez Enable/Disable et passez une commande de test.

6. Lorsque vous êtes prêt, saisissez les identifiants de production et décochez Sandbox Mode.

Les URL de retour et de notification sont envoyées à chaque paiement. Rien n'a besoin d'être configuré dans le portail 2C2P.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > 2C2P. Au-dessus des champs, la page affiche Sandbox mode is active. No real transactions will be processed. lorsque le mode sandbox est activé. Elle vous prévient lorsque la passerelle est activée mais que l'identifiant marchand ou la clé secrète du mode en cours est vide, et lorsque la devise de la boutique n'est pas prise en charge. Dans les deux cas, le moyen de paiement est masqué au paiement. Lorsque vous enregistrez avec Sandbox Mode désactivé, l'extension demande les identifiants de production s'ils sont vides.

Général

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

Title: le nom du moyen de paiement que voit le client au paiement. Par défaut : 2C2P Payment.

Description: le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. En mode sandbox, (TEST MODE) y est ajouté.

Mode test (sandbox)

Sandbox Mode: Enable sandbox / test mode envoie les paiements vers le sandbox 2C2P (demo2.2c2p.com) avec les identifiants sandbox ci-dessous. Par défaut : activé. Décochez-le pour recevoir de vrais paiements.

Sandbox Merchant ID: votre identifiant marchand 2C2P de sandbox.

Sandbox Secret Key: votre clé secrète 2C2P de sandbox.

Identifiants API de production

Utilisés lorsque le mode sandbox est désactivé.

Merchant ID: votre identifiant marchand 2C2P de production. Obligatoire lorsque le mode sandbox est désactivé.

Secret Key: votre clé secrète 2C2P de production. Obligatoire lorsque le mode sandbox est désactivé. La clé est enregistrée exactement comme saisie, y compris les guillemets et les antislashs.

Page de paiement

Cette section indique, à titre de référence, l'URL de retour côté client (https://your-site/?wc-api=tc2p_p) et l'URL de notification côté serveur (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1). Elles sont envoyées automatiquement à chaque paiement.

Payment Page Language: la langue de la page de paiement 2C2P. Par défaut : English.

Redirect API version: gardez 8.5, sauf si 2C2P vous a indiqué que votre compte utilise encore l'ancienne version 7.0 (signatures SHA-1). Les résultats des paiements commencés avant un changement restent vérifiés.

Order ID prefix: facultatif, lettres et chiffres uniquement (10 caractères maximum), par exemple SHOP1. 2C2P refuse un identifiant de commande qu'il a déjà reçu. Définissez un préfixe unique lorsque plusieurs boutiques partagent un même compte 2C2P, et en sandbox, où les comptes marchands de test sont partagés. Les autres caractères sont supprimés à l'enregistrement, avec un avertissement.

Réglages avancés

Enable Logging: Log 2C2P events écrit dans WooCommerce > Status > Logs, source wcp_2c2p_payment. Aucune donnée de carte ni clé secrète n'est journalisée. Par défaut : désactivé.

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. Par défaut : désactivé.

Fonctionnement au paiement

Le client choisit le moyen de paiement (par défaut 2C2P Payment) et passe sa commande. La page suivante affiche Thank you for your order. You will be redirected to 2C2P to complete your payment. et redirige le client vers la page de paiement 2C2P après un court délai. Si cela ne se produit pas, le client clique sur Pay via 2C2P. La page comporte aussi un bouton Cancel order.

Sur la page 2C2P, le client paie avec n'importe quel moyen activé sur votre compte 2C2P, par exemple cartes, portefeuilles électroniques, paiements par QR code, banque en ligne ou paiements en espèces. L'extension transmet le total de la commande dans la devise de la commande, l'e-mail de facturation du client et les noms des produits commandés. Le paiement peut être finalisé dans un délai de 24 heures.

2C2P transmet le résultat deux fois : le navigateur du client revient à la boutique, et 2C2P envoie une notification serveur à serveur. Les deux sont traités de la même façon. La commande n'est marquée payée qu'après confirmation de 2C2P avec une signature valide. Le résultat doit aussi correspondre à la commande : l'identifiant marchand, la clé de commande, l'identifiant de commande et le moyen de paiement sont vérifiés. Les résultats sans signature valide sont rejetés.

Après un paiement réussi ou en attente, le client arrive sur la page de confirmation de commande et le panier est vidé. Si le paiement n'a pas été finalisé, le client revient au paiement avec le message Payment was not completed. Please try again or choose a different payment method. La commande est annulée, le panier est conservé et le client passe une nouvelle commande. Si le résultat ne peut pas être confirmé, le client voit We could not confirm the payment result. If your account was charged, please contact us before paying again.

Le moyen de paiement fonctionne avec le paiement classique et avec le bloc Paiement. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

L'extension ne gère ni les remboursements depuis WooCommerce, ni les cartes enregistrées, ni les paiements récurrents ou WooCommerce Subscriptions, ni les champs de carte sur votre site, et elle ne prend pas en charge l'API 2C2P PGW 4.x.

Commandes

Statuts de commande

Pending payment: le client a été redirigé vers 2C2P et aucun résultat n'est encore arrivé.

Processing or Completed: 2C2P a signalé un paiement réussi (statut 000). WooCommerce passe la commande à « En cours », ou à « Terminée » pour les commandes ne contenant que des produits virtuels téléchargeables. La note de commande indique la transaction 2C2P, le code d'autorisation, la date et le canal de paiement. L'identifiant de transaction est la référence de transaction 2C2P.

On hold: le paiement est en attente chez 2C2P (statut 001), par exemple un paiement en espèces que le client n'a pas encore effectué. La commande devient payée lorsque 2C2P signale le paiement. Une commande est aussi mise en attente lorsque 2C2P signale un montant ou une devise différents du total de la commande. La note de commande indique les valeurs reçues et attendues. Vérifiez la commande et la transaction dans le portail 2C2P.

Cancelled: le paiement a été refusé, annulé par le client ou a échoué (statuts 002, 003, 999). La note de commande indique le statut et la raison.

Une commande payée ou remboursée n'est jamais modifiée par un résultat ultérieur, et un ancien résultat répété ne rouvre pas une commande que vous avez annulée.

Remboursements

Les remboursements depuis WooCommerce ne sont pas pris en charge. Remboursez le paiement dans le portail marchand 2C2P, puis créez un remboursement manuel dans WooCommerce.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > 2C2P. 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-le dans votre compte vibefox.net.

Sans clé active, 2C2P 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 connectés de la boutique 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 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 l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

2C2P n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode en cours dispose d'un identifiant marchand et d'une clé secrète : les champs sandbox en mode sandbox, les champs de production en mode production. Vérifiez que la devise de la boutique est prise en charge. La page des réglages affiche un avertissement dans les deux cas.

Le paiement a été effectué, mais la commande reste « En attente de paiement » : aucun résultat valide n'est parvenu à votre boutique. Vérifiez que l'identifiant marchand et la clé secrète du mode en cours correspondent au compte 2C2P utilisé pour le paiement, et que Redirect API version correspond à votre compte. Un résultat avec une mauvaise signature ou pour un autre identifiant marchand est rejeté. Activez Enable Logging et recherchez les messages de hachage ou d'identifiant marchand dans WooCommerce > Status > Logs. Vérifiez aussi que votre serveur accepte les requêtes de 2C2P vers l'URL de notification côté serveur.

2C2P indique que l'identifiant de commande existe déjà : 2C2P n'accepte pas deux fois le même identifiant de commande. Cela arrive lorsque plusieurs boutiques partagent un même compte 2C2P, ou en sandbox, où les comptes marchands de démonstration sont partagés par de nombreux développeurs. Définissez un Order ID prefix unique.

Un paiement a été effectué, mais la commande est « En attente » : soit le paiement est encore en attente chez 2C2P (par exemple un paiement en espèces que le client n'a pas encore effectué), soit le montant ou la devise payés ne correspondaient pas à la commande. Vérifiez les notes de commande et la transaction dans le portail 2C2P.

Le client voit le message « This payment method is currently unavailable for this order » : la devise de la commande n'est pas prise en charge, ou l'identifiant marchand ou la clé secrète du mode en cours est vide.

Please enter your live Merchant ID or Please enter your live Secret Key on save: le mode sandbox est désactivé et un champ de production est vide. Saisissez les identifiants de production ou laissez Sandbox Mode activé.

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, l'extension continue de fonctionner avec le dernier statut connu.

Désinstallation

La désactivation de 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, les données 2C2P enregistrées sur les commandes et les fichiers journaux ne sont supprimés que si Delete Data on Uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

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