Retour

VibeFox Kushki for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec 3.0.5.0) ou 4.0.2 et ultérieur (testé avec 4.1.0.3).

PHP : 8.0 ou ultérieur.

Devise : USD (Équateur) ou COP (Colombie). Pour les commandes dans d'autres devises, le mode de paiement n'est pas affiché lors du paiement.

HTTPS : Kushki exige que la page de paiement soit servie en HTTPS en mode réel.

Compte Kushki : vous avez besoin des identifiants marchands public et privé (Merchant ID) de votre compte de test (UAT) Kushki et de votre compte de production. Ils se trouvent dans la Kushki Console, sous Developers > Credentials. Pour le webhook facultatif, vous avez aussi besoin de la clé de signature du webhook de chaque compte (voir Configuration).

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

Installation

Le téléchargement est un fichier zip unique contenant les paquets des deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_kushki_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_kushki_payment.ocmod.zip. N'installez que le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_kushki_payment-oc3-(version).ocmod.zip. L'extension n'apporte aucune modification OCMOD, donc Extensions > Modifications n'a pas besoin d'être actualisé. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Kushki Payment et cliquez sur Install (le bouton vert +). Votre utilisateur administrateur doit avoir le droit de modifier la liste des extensions de paiement.

3. Cliquez sur Edit (le bouton crayon) pour ouvrir la page des paramètres. Collez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Saisissez les identifiants marchands public et privé de test et laissez Test mode activé. Vous pouvez également configurer le webhook dans la Kushki Console et coller sa clé de signature (voir Configuration).

5. Activez Enable / Disable, cliquez sur Save et passez une commande test. Une fois prêt, saisissez les identifiants marchands réels (et la signature du webhook réel) puis désactivez Test mode.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_kushki_payment.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension dans le nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Kushki Payment, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence, les identifiants marchands et le webhook comme aux étapes 3 à 5 pour OpenCart 3. La page de configuration et ses champs sont identiques dans les deux versions. Seul le webhook est différent (voir Webhook).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode test activé.

Configuration

Tous les paramètres se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Kushki Payment > Edit. Les sections sont listées à gauche ; le bouton Save sous la liste enregistre toute la page. Au-dessus des paramètres, la page vous avertit lorsque le mode de paiement est activé mais que les identifiants marchands du mode actuel sont absents (le mode de paiement est alors masqué lors du paiement), lorsque la devise par défaut de votre boutique n'est ni USD ni COP, lorsque le mode réel est utilisé sans HTTPS (sous OpenCart 4, lorsque l'adresse de la vitrine commence par http://) et lorsque le mode actuel n'a pas de clé de signature de webhook. Tant que le mode test est activé, elle affiche Test mode is on: the Kushki test environment is used, no real money is charged. Sans le droit de modifier l'extension, la page affiche les paramètres mais ne peut pas les enregistrer.

À l'enregistrement, Title ne doit pas être vide ni dépasser 128 caractères, Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre égal ou supérieur à 0, et chaque statut de commande doit exister. Si un champ est incorrect, rien n'est enregistré et la page indique le champ concerné. Les espaces autour des identifiants sont supprimés à l'enregistrement.

Kushki

Enable / Disable : Enable Kushki card payments active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement que les clients voient lors du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit / debit card (Kushki). Obligatoire, jusqu'à 128 caractères.

Description : le texte affiché au-dessus du formulaire de carte à l'étape Confirm Order. Par défaut : Pay securely with your card. Card details are entered in a Kushki form and never stored on this site.

Sort Order : la position de Kushki parmi les modes de paiement lors du paiement. Laissez vide ou saisissez un nombre entier.

Geo Zone : proposer Kushki uniquement pour les adresses de paiement situées dans la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

Total : le montant total du panier, dans la devise par défaut de la boutique, qu'une commande doit atteindre pour que Kushki soit proposé. Laissez vide pour proposer Kushki quel que soit le montant.

Identifiants API

Copiez les identifiants marchands public et privé depuis la Kushki Console (Developers > Credentials ; la page renvoie vers la Console). Les comptes de test (UAT) et de production ont des identifiants différents. Le mode test n'utilise que les identifiants de test, le mode réel uniquement les identifiants réels.

Test mode : utilise l'environnement de test Kushki (UAT) : les identifiants marchands de test, le formulaire de carte de test et l'API de test ensemble. Aucun argent réel n'est débité, et un badge TEST MODE est affiché lors du paiement. Par défaut : activé. Désactivez-le pour accepter de vrais paiements. Les remboursements vont toujours dans l'environnement où le paiement a été effectué.

Test Public Merchant ID : l'identifiant marchand public de votre compte de test Kushki. Il charge le formulaire de carte.

Test Private Merchant ID : l'identifiant marchand privé de votre compte de test Kushki. Il est utilisé sur le serveur pour les débits et les remboursements.

Live Public Merchant ID : l'identifiant marchand public de votre compte de production Kushki.

Live Private Merchant ID : l'identifiant marchand privé de votre compte de production Kushki. Gardez-le secret.

Les identifiants marchands privés et les signatures de webhook enregistrés ne sont plus jamais affichés. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ puis cliquez sur Save.

Webhook (recommandé)

Les paiements sont confirmés immédiatement par la réponse de l'API Kushki, le webhook n'est donc pas obligatoire. Il confirme en plus un paiement dont la réponse a été perdue (par exemple lors d'un délai d'attente) et signale les annulations, remboursements et rétrofacturations (chargebacks) effectués dans la Kushki Console. Dans la Kushki Console (Webhooks), ajoutez l'URL affichée dans Webhook URL dans cette section. Sous OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_kushki_payment/webhook, et sous OpenCart 4 à https://your-store/index.php?route=extension/wcp_kushki_payment/payment/wcp_kushki_payment.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle qu'elle est affichée dans les paramètres. Faites-le pour le compte de test et pour le compte de production.

L'extension gère ces notifications de carte :

Débit approuvé : confirme une commande dont la réponse de débit a été perdue, ou confirme une commande au statut de vérification lorsque le numéro de ticket, le montant et la devise correspondent.
Débit refusé : clôture une tentative de débit en attente. Une commande au statut de vérification pour ce même débit passe au statut Failed Status.
Annulations, remboursements, rétrofacturations et autres événements : ajoutés aux notes de la commande. Le statut de la commande ne change pas.

Test webhook signature : la clé de signature du webhook du compte de test Kushki (Console > Webhooks).

Live webhook signature : la clé de signature du webhook du compte de production Kushki.

Les webhooks sans signature valide sont rejetés. Une notification doit être signée avec la clé du mode dans lequel le paiement a été effectué ; ainsi, une notification de test ne confirme jamais un paiement réel. Sans clé de signature, toutes les notifications webhook sont rejetées, mais les paiements fonctionnent toujours, car ils sont confirmés par la réponse de l'API.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (commande manquante). La commande ne reçoit un statut qu'après l'approbation du débit de la carte par Kushki. Chaque champ ci-dessous liste les statuts de commande de votre OpenCart.

Order Status After Payment : Kushki a approuvé le débit avec un numéro de ticket, pour le montant et la devise de la commande. Par défaut : En cours.

On Hold (Review) Status : Kushki a approuvé le débit sans numéro de ticket, ou a signalé un autre montant ou une autre devise. Une note explique la raison ; vérifiez le paiement dans la Kushki Console avant l'expédition. Par défaut : En attente de paiement, car OpenCart n'a pas de statut « En attente ». Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Failed Status : une commande au statut de vérification dont le débit est ensuite signalé comme refusé par Kushki (webhook). Par défaut : Échoué.

Canceled Status : les commandes à ce statut (ou au statut remboursé) ne sont jamais réouvertes par un webhook tardif. Par défaut : Annulée.

Refunded Status : défini après le remboursement du paiement depuis l'onglet de la commande. Par défaut : Remboursée.

Avancé

Debug log : écrit les requêtes et les webhooks Kushki dans kushki_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Les avertissements et les erreurs sont toujours journalisés. Les journaux ne contiennent jamais d'identifiants marchands, de jetons de carte ni d'adresses e-mail de clients. Par défaut : désactivé.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete data on uninstall : lorsqu'il est activé, la désinstallation de l'extension supprime les paramètres et le journal. Les enregistrements de paiement Kushki (débits et remboursements) sont toujours conservés, afin que les anciennes commandes puissent encore être remboursées après une réinstallation. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les paramètres dans un fichier JSON. Les identifiants marchands privés et les signatures de webhook ne sont pas exportés.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les paramètres. Les secrets enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit / debit card (Kushki)). OpenCart crée la commande à l'étape Confirm Order, toujours sans statut. Le client y voit votre description et le formulaire de carte Kushki avec le montant total de la commande dans la devise de la commande. Le client saisit sa carte, choisit les paiements en plusieurs fois si le formulaire Kushki les propose, et appuie sur le bouton de paiement à l'intérieur du formulaire Kushki. Le paiement est alors envoyé automatiquement, comme l'indique la note sous le formulaire : Enter your card in the secure Kushki form above and press its pay button — the payment is sent automatically. Si le client clique sur le bouton Confirm Order d'OpenCart à la place, le message Please enter your card details in the Kushki form and press its pay button. s'affiche.

Sous OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc du mode de paiement, dans la fenêtre Payment method options. Le formulaire de carte Kushki apparaît alors dans le bloc de confirmation de la commande en bas de la page de paiement, au-dessus du bouton Confirm Order, et est reconstruit pour le total de la commande à chaque rechargement de ce bloc par OpenCart.

Votre boutique débite ensuite la carte sur le serveur. La commande n'est marquée comme payée qu'après la confirmation de Kushki avec un numéro de ticket. La commande reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails de commande habituels et la mise à jour du stock ; le panier est vidé, et le client voit la page de confirmation de commande d'OpenCart avec Your card payment has been received. Le montant et la devise communiqués par Kushki sont comparés à la commande. Une commande au statut de vérification affiche Your payment is being reviewed. We will update your order as soon as the review is complete.

Si la carte est refusée, la commande reste sans statut, le client reste à l'étape Confirm Order avec Your payment was declined et le motif indiqué par Kushki, et peut essayer une autre carte dans le formulaire rechargé. En cas de problème de réseau, de clé ou de serveur, le client voit The payment could not be processed right now. Please try again in a moment or choose another payment method. La raison technique est écrite dans le journal et dans les notes de la commande. Un second clic pendant le traitement d'un paiement affiche A payment for this order is already being processed. Please wait a moment and check your order status.

OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 garde une commande pour le paiement et la met à jour. Dans les deux cas, un panier n'est payé qu'une seule fois : un panier déjà payé, ou un débit approuvé dont la commande n'a pas encore de statut, n'est jamais débité à nouveau, et le client voit la page de succès. Si la réponse de Kushki est perdue (par exemple lors d'un délai d'attente), le client voit le message général, mais la tentative de débit est conservée. Lorsque le webhook signé signale le débit approuvé, la commande reçoit son statut. Si le client paie à nouveau avant l'arrivée de tout webhook, il s'agit d'un nouveau débit ; une approbation tardive du premier débit ajoute alors seulement une note sur un éventuel double débit.

OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès. Si cette commande a été fermée sans paiement entre-temps (par exemple un débit en cours d'examen a finalement été refusé, ou vous avez annulé la commande), ou si elle est déjà payée pour un panier antérieur et que le client a modifié le panier depuis, le client est renvoyé à la page de paiement lorsqu'il paie, et le prochain Confirm Order crée une nouvelle commande. Au-dessus de la page de paiement, le client voit Your previous order is closed (declined, cancelled or refunded by the store). Please confirm the order again: the cart will be paid with a new order. si la commande a été fermée, ou Your previous order is already paid for other cart contents. Please confirm the order again: the current cart will be paid with a new order. si elle a été payée pour un panier antérieur. Une modification du panier, y compris une nouvelle quantité, compte comme un nouveau panier qui nécessite son propre paiement.

Le webhook fonctionne aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sous OpenCart 4 l'extension ajoute une action de démarrage qui laisse passer le webhook. Le 3-D Secure, les règles antifraude et les paiements en plusieurs fois proposés se configurent dans la Kushki Console.

L'extension ne prend en charge que les paiements par carte en une seule étape. Elle ne gère ni remboursements partiels, ni cartes enregistrées, ni abonnements, ni paiements en espèces, par virement bancaire (PSE) ou par redirection vers une carte de débit, ni autorisation et capture séparées.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client n'a pas payé, la carte a été refusée, ou la réponse de Kushki a été perdue et le webhook n'est pas encore arrivé. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Order Status After Payment (par défaut En cours) : Kushki a confirmé le débit (par la réponse de l'API ou par le webhook). Une note affiche le mode, le montant, le numéro de ticket Kushki et la référence.

On Hold (Review) Status (par défaut En attente de paiement) : Kushki a renvoyé un succès sans numéro de ticket, ou a signalé un montant ou une devise différents de ceux de la commande. La note l'explique. Vérifiez la transaction dans la Kushki Console, puis expédiez la commande ou remboursez le paiement. Une approbation signée ultérieure avec un numéro de ticket et un montant correspondant fait passer la commande à Order Status After Payment.

Failed Status (par défaut Échoué) : le webhook a signalé que le débit d'une commande au statut de vérification a été refusé.

Refunded Status (par défaut Remboursée) : le paiement a été remboursé via l'extension.

Si Kushki signale un autre débit approuvé pour une commande déjà payée, annulée ou remboursée, la commande n'est pas modifiée. Une note vous invite à vérifier s'il s'agit d'un double débit et à le rembourser dans la Kushki Console. Un webhook de l'environnement de test pour un paiement réel (ou l'inverse) est ignoré avec une note.

Les notes sont des entrées de l'historique (History) de la commande que le client ne voit pas.

Onglet VibeFox Kushki Payment

Dans Sales > Orders, ouvrez une commande payée avec Kushki. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Kushki Payment affiche le Ticket number (avec une étiquette TEST pour les paiements de test), la Transaction reference, l'Environment, le Result, les montants Charged / order amount, le formulaire de remboursement, l'historique des remboursements et les Kushki notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Kushki rembourse la totalité du débit, seuls les remboursements complets sont donc possibles. Dans l'onglet VibeFox Kushki Payment, le champ Amount débité par Kushki est pré-rempli. Saisissez éventuellement un Reason (optional), cliquez sur Refund via Kushki, puis confirmez la question Refund the full payment through Kushki? This cannot be undone. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Pour tout autre montant, l'extension affiche Kushki refunds the full payment only. Enter the full charged amount avec le montant, et rien n'est envoyé. Le remboursement se fait dans le montant et la devise débités par Kushki ; ainsi, après un écart de montant, le client récupère ce qui a réellement été débité, et non le total de la commande. Un paiement ne peut être remboursé qu'une seule fois.

Le remboursement est envoyé dans le mode où le paiement a été effectué (test ou réel), la clé privée marchand de ce mode doit donc être renseignée. Si Kushki n'accepte pas le remboursement, l'onglet affiche Kushki refund failed avec le code et le message de Kushki, et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes avec le numéro de ticket du remboursement Kushki, et la commande passe au statut Refunded Status sans notifier le client et sans remettre les produits en stock, comme pour une modification manuelle du statut. Les remboursements nécessitent un débit Kushki confirmé avec un numéro de ticket.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Kushki. Les annulations et remboursements effectués dans la Kushki Console arrivent par webhook et sont ajoutés aux notes. Le statut de la commande ne change pas automatiquement.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Kushki Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox Kushki Payment > Edit, au-dessus des paramètres. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour supprimer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-kushki et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify pour l'extension peuvent modifier la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré une place de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : l'adresse de la boutique issue de la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas sa place de domaine. Libérez la place dans votre compte vibefox.net.

Sans clé active, Kushki n'est pas proposé aux clients lors du paiement. Si un paiement est malgré tout lancé, le client voit This payment method is not available. Please choose another one. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit toujours le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sous OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion administrateur, donc sans clé active le mode de paiement est masqué pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. 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, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié automatiquement à l'ouverture du Dashboard ou de la page Edit de l'administration : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et le statut de licence.

Dépannage

Kushki n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable / Disable est activé et que le mode actuel dispose des deux identifiants marchands : les identifiants de test en mode test, les identifiants réels en mode réel. La page des paramètres affiche un avertissement lorsque des identifiants manquent. Vérifiez que la devise de la commande est USD ou COP, que l'adresse de paiement se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les paramètres.

Le paiement a abouti, mais la commande reste sans statut : la réponse de l'API Kushki a été perdue, par exemple à cause d'un délai d'attente. Le webhook confirme ces paiements. Dans la Kushki Console, vérifiez que l'URL du webhook est exactement celle affichée dans Webhook URL, pour le compte correspondant au mode que vous utilisez, et que la clé de signature de ce compte se trouve dans le champ correspondant (Test webhook signature ou Live webhook signature). Un débit approuvé sans le montant et la devise payés place la commande dans On Hold (Review) Status.

Le webhook répond Webhook signature not configured : aucune signature de webhook n'est définie. Collez la clé de signature dans les paramètres.

Le webhook répond Invalid signature : la clé de signature appartient à un autre compte ou à un autre mode, ou la notification a été modifiée en cours de route.

Le webhook répond Order mismatch : la notification n'appartient à aucune tentative de débit de cette commande (clé de tentative ou transaction incorrecte). Rien n'est modifié.

Le webhook répond Busy, retry later : la commande était en cours de traitement par une autre requête au même moment, ou le statut de la commande n'a pas pu être défini. Kushki peut renvoyer la notification. Les erreurs sont toujours écrites dans le journal.

L'URL du webhook affiche POST uniquement dans le navigateur : c'est normal. L'URL n'accepte que les notifications de Kushki.

Le formulaire de carte ne se charge pas : le client voit The Kushki card form could not be loaded. Please reload the page or choose another payment method. Vérifiez l'identifiant marchand public du mode actuel.

Le client voit This payment option is not available in this store. Please pay by card.: une option de paiement autre que la carte a été choisie dans le formulaire Kushki. L'extension ne débite que les cartes.

Le client voit une erreur lors du paiement : activez Debug log et consultez le champ Log sur la page de l'extension. This payment method is not available. Please reload the checkout page. signifie que la session de paiement ne correspond plus à la commande, ou que le mode de paiement a été désactivé entre-temps : le client doit recharger la page de paiement. Une clé privée marchand incorrecte ou absente donne le message général indiquant que le paiement n'a pas pu être traité.

Le client voit Your payment was received, but the order could not be completed automatically : Kushki a approuvé le débit, mais OpenCart n'a pas pu définir le statut de la commande. Le journal indique la raison. La prochaine tentative de paiement du même panier définit le statut sans nouveau débit.

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

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : le paiement est déjà remboursé, la commande n'a pas de numéro de ticket Kushki (No Kushki ticket number found for this order — refund it in the Kushki Console.), votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou la clé privée marchand du mode du paiement n'est pas définie.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Kushki Payment. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres paramètres de l'extension : Enable / Disable, Sort Order, Geo Zone, Total et les statuts de commande de la section Orders, qui reprennent leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sous OpenCart 4, également ses événements, y compris celui qui affiche le message au-dessus de la page de paiement, et son action de démarrage, qui laisse passer le webhook en mode maintenance). Si Delete data on uninstall est activé, les autres paramètres (titre, description, mode test, identifiants marchands, signatures de webhook, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les enregistrements de paiement Kushki (débits et remboursements) sont toujours conservés, afin que les commandes payées auparavant puissent encore être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sous OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation, cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Kushki Payment dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de poubelle) pour supprimer le paquet téléversé.

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