VibeFox Omise for WooCommerce — Aide

Prérequis

WordPress : 6.2 ou ultérieur.

WooCommerce : 8.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui ; si WooCommerce est désactivé ensuite, la passerelle n'est pas chargée et un avis d'administration s'affiche.

PHP : 8.0 ou ultérieur.

HTTPS : les champs de carte se trouvent sur votre page de paiement ; celle-ci doit donc être servie en HTTPS et rester exempte de scripts non fiables. Les données de carte n'atteignent malgré tout jamais votre serveur. Omise n'envoie des webhooks qu'à des adresses HTTPS.

Devise de la boutique : l'une de THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD. Pour les autres devises, le moyen de paiement est masqué sur la page de paiement.

Compte Omise : vous avez besoin de la clé publique et de la clé secrète de votre compte Omise, pour le mode test comme pour le mode production, disponibles dans Settings > Keys du tableau de bord Omise, ainsi que d'un point de terminaison de webhook dans Settings > Webhooks (voir Configuration).

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 transférer le dossier wcp_omise_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Omise > Manage, ou cliquez sur Settings sous le nom de l'extension dans 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 vos clés Omise de test et de production, puis ajoutez dans le tableau de bord Omise l'URL du webhook affichée sur la page de réglages (voir Configuration).

6. Activez Enable/Disable. Testez un paiement en mode test avec une carte de test Omise, par exemple 4242 4242 4242 4242, puis décochez Test mode.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Omise. Au-dessus des champs, la page affiche Test mode is on — orders are charged with the test keys, no real money is moved. tant que le mode test est activé, et vous avertit si la clé publique ou la clé secrète du mode actuel manque, ou si Omise ne prend pas en charge la devise de la boutique. Dans les deux cas, le moyen de paiement est masqué sur la page de paiement. Dans la liste des moyens de paiement, Omise est signalé comme nécessitant une configuration tant que les deux clés du mode actuel ne sont pas saisies.

Général

Enable/Disable: Enable card payments via Omise active ou désactive le moyen de paiement. Par défaut : désactivé.

Title: le nom du moyen de paiement que voient les clients sur la page de paiement. Par défaut : Credit / Debit Card.

Description: le texte affiché au-dessus du formulaire de carte sur la page de paiement. Par défaut : Pay securely with your credit or debit card via Omise.

Clés API

Vos clés se trouvent dans le tableau de bord Omise, sous Settings > Keys. Les clés de test commencent par pkey_test_ et skey_test_, les clés de production par pkey_ et skey_. À l'enregistrement, une clé au mauvais préfixe (par exemple une clé de test dans un champ de production) est refusée avec une erreur, et la valeur précédente est conservée.

Test mode: Use the test keys (no real charges). Bascule les deux clés. Les remboursements, captures et vérifications de statut d'une commande utilisent toujours les clés du mode dans lequel la commande a été payée. Par défaut : activé.

Test public key: la clé publique du mode test, pkey_test_...

Test secret key: la clé secrète du mode test, skey_test_...

Live public key: la clé publique du mode production, pkey_...

Live secret key: la clé secrète du mode production, skey_...

Paiement et webhook

La section affiche l'URL du webhook de votre boutique. Elle ressemble à https://your-site/wp-json/omise-payment/v1/webhook. Copiez-la exactement comme les réglages l'affichent et ajoutez-la dans le tableau de bord Omise, sous Settings > Webhooks (HTTPS uniquement). L'extension gère ces événements :

Le contenu du webhook n'est jamais considéré comme fiable : le débit doit être celui enregistré sur la commande, et son statut est relu depuis l'API Omise avec les clés du mode de la commande. Sans webhook, une commande dont le client ferme le navigateur pendant le 3-D Secure reste En attente jusqu'à ce que vous lanciez Omise: Sync payment status, et les captures effectuées dans le tableau de bord Omise ne sont pas reprises automatiquement.

Payment action: ce qui se passe pour le montant de la carte.

Per-charge webhook: Send the webhook URL with every charge. Utile lorsque plusieurs boutiques partagent un même compte Omise. Ne fonctionne que si le site utilise HTTPS ; sinon, le webhook du tableau de bord est utilisé. Par défaut : désactivé.

Avancé

Debug log: Log API requests and payment events écrit les événements dans WooCommerce > Status > Logs, source wcp_omise_payment. Les clés, jetons et données de carte ne sont jamais journalisés. Par défaut : désactivé.

Delete data on uninstall: Remove the settings and debug logs when the plugin is deleted. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut Credit / Debit Card) et remplit le formulaire de carte : Name on card, Card number, Expiry month (MM), Expiry year (YYYY) et Security code (CVV). En mode test, le formulaire affiche TEST MODE — use Omise test cards (e.g. 4242 4242 4242 4242), no real charges are made.. Lorsque la commande est passée, Omise.js transforme la carte en jeton à usage unique dans le navigateur. Les champs de carte ne sont jamais envoyés à votre serveur.

Votre boutique crée le débit avec la clé secrète pour le total de la commande, dans la devise de la commande. La description du débit est le nom de la boutique et le numéro de commande, et l'identifiant de commande est enregistré dans les métadonnées du débit. Si la banque exige le 3-D Secure, le client est redirigé vers sa banque, puis revient sur votre boutique. Le résultat est toujours relu depuis l'API Omise.

La commande n'est marquée payée qu'après confirmation d'Omise : le débit doit être capturé, et son montant et sa devise doivent correspondre à la commande. Avec Authorize only, la commande passe en attente après une autorisation réussie. Le client voit la page de confirmation de commande.

Si la carte est refusée, le client reste sur la page de paiement avec Payment failed: et un motif, par exemple un solde insuffisant, un code de sécurité invalide ou un refus de la banque émettrice, et il peut réessayer. Après un échec du 3-D Secure, le client est dirigé vers la page Pay for order. Si le paiement ne peut pas être confirmé juste après le 3-D Secure, le client voit We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again.

Une nouvelle tentative ne débite jamais deux fois : si le débit précédent de la commande est déjà payé ou autorisé, la commande est finalisée sans nouveau débit. Une tentative 3-D Secure inachevée expire avant la création d'un nouveau débit.

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 cartes. Elle ne propose aucun autre moyen de paiement Omise (PromptPay, TrueMoney, banque mobile, paiements en plusieurs fois, Konbini, PayNow), ni cartes enregistrées ou clients Omise, ni abonnements, ni capture partielle.

Commandes et remboursements

Statuts de commande

En attente de paiement : le client est sur le 3-D Secure ou n'a pas encore payé.

En cours : le paiement a été confirmé. Les commandes ne contenant que des produits virtuels téléchargeables passent à Terminée, comme d'habitude dans WooCommerce. La note de commande indique le montant, l'identifiant du débit et la manière dont il a été confirmé (paiement, retour du 3-D Secure, webhook, capture manuelle ou synchronisation manuelle). L'identifiant de transaction est l'identifiant de débit Omise (chrg_...).

En attente, capture à faire : la carte a été autorisée avec Authorize only. Utilisez Omise: Capture payment ou Omise: Void authorization.

En attente, paiement non confirmé : Omise n'a pas encore confirmé le paiement, par exemple parce que le client a fermé le navigateur pendant le 3-D Secure. Le webhook ou Omise: Sync payment status met la commande à jour.

En attente, écart : le montant ou la devise du débit diffère de la commande. La note affiche les deux valeurs. Vérifiez la commande, puis finalisez-la ou remboursez le paiement.

Échouée : le paiement a été refusé. Une commande payée n'est jamais rétrogradée par un événement d'échec ultérieur.

Annulée : le débit a expiré ou l'autorisation a été annulée.

Si un débit payé ou autorisé arrive pour une commande déjà Annulée ou Remboursée, la commande n'est pas rouverte. Une note vous invite à vérifier le tableau de bord Omise, puis à rembourser ou rouvrir la commande manuellement.

Actions de commande

Omise: Capture payment: capture le montant autorisé total. Affiché uniquement pour les commandes autorisées.

Omise: Void authorization: annule l'autorisation ; aucun montant n'est capturé et la commande est annulée. Affiché uniquement pour les commandes autorisées.

Omise: Sync payment status: lit le débit chez Omise et met la commande à jour. La note indique aussi le total remboursé chez Omise.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Omise. Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé dans le mode dans lequel le paiement a été effectué ; la clé secrète de ce mode doit donc être renseignée. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de remboursement Omise. Pour une autorisation non encore capturée, seul un remboursement total est possible, et il annule l'autorisation. Si Omise refuse le remboursement, WooCommerce affiche Refund failed. avec le message d'Omise et aucun remboursement n'est enregistré.

Les remboursements effectués dans le tableau de bord Omise ne sont pas importés comme remboursements WooCommerce. Omise: Sync payment status affiche le total remboursé ; créez des remboursements manuels correspondants dans WooCommerce si nécessaire.

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 > Omise. 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 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, Omise n'est pas proposé 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 moyen de paiement, marqué (unlicensed — visible to admins only), afin de pouvoir 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 touchées : les paiements déjà lancés sont toujours confirmés, et les captures et remboursements fonctionnent.

Lorsqu'une licence expire, l'extension 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

Omise n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que les deux clés du mode actuel sont saisies (clés de test en mode test, clés de production sinon) et que la devise est prise en charge. Sur la page Pay for order, c'est la devise de la commande qui compte. La page de réglages affiche un avertissement lorsque les clés ou la devise sont incorrectes.

Le paiement a abouti, mais la commande reste En attente de paiement ou En attente : le webhook ne fonctionne pas. Dans le tableau de bord Omise, vérifiez que l'URL du webhook est exactement celle des réglages et qu'elle utilise HTTPS. Lancez ensuite Omise: Sync payment status sur la commande. Activez le Debug log pour voir les réponses du webhook.

Le webhook répond Earlier charge of the order, order not changed : l'événement concerne une tentative antérieure de la commande, remplacée par une nouvelle tentative. Rien n'est modifié sur la commande. Si ce débit antérieur est toujours payé ou autorisé chez Omise, une note de commande le signale une fois : vérifiez dans le tableau de bord Omise l'éventuel double paiement, puis remboursez-le ou annulez-le là-bas.

Le webhook répond Charge ID does not match order : le débit de l'événement appartient à une autre commande. Rien n'est modifié.

Le webhook répond Order is being processed, retry later ou Failed to verify charge : la commande était verrouillée par une autre requête, ou l'API Omise était injoignable. Omise relance le webhook.

Erreur à l'enregistrement : key must start with ... ou must be a live key : une clé a été collée dans le mauvais champ. Les clés de test commencent par pkey_test_ / skey_test_, les clés de production par pkey_ / skey_.

Le client voit Card payments are temporarily unavailable : les clés sont incorrectes, ou le jeton de carte appartient à l'autre mode (un jeton de test en production, ou l'inverse). Vérifiez les clés et Test mode.

Le client voit We could not reach the payment provider : aucune réponse valide n'est venue d'Omise lors de la création du débit. Un débit a peut-être quand même été créé ; la note de commande vous demande de vérifier le tableau de bord Omise avant de débiter à nouveau la commande.

Le client voit This order is already being paid : le paiement a été envoyé deux fois au même moment. Le client patiente et consulte son e-mail avant de réessayer.

La commande est En attente après le paiement : lisez la note de commande. La commande attend la capture, Omise n'a pas encore confirmé le paiement, ou le montant ou la devise diffère de la commande.

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

Le remboursement partiel d'une commande autorisée échoue : le paiement n'est qu'autorisé. Capturez-le d'abord, ou remboursez le montant total pour l'annuler.

Le bloc de licence affiche une erreur : suivez le message affiché. 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

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 ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les données Omise enregistrées sur les commandes constituent l'historique des paiements et sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

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