VibeFox Tranzila for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Devise : ILS, USD, EUR ou GBP. Pour les autres devises des clients, le mode de paiement est masqué au moment du paiement.

Terminal Tranzila : vous avez besoin du nom du terminal. Le mot de passe du terminal (TranzilaPW) est nécessaire pour le handshake et pour les remboursements depuis la page de la commande. Certains terminaux exigent aussi un mot de passe de crédit distinct (CreditPass) pour les remboursements. Le nom du terminal et les mots de passe vous sont fournis par Tranzila : consultez les paramètres de votre terminal ou demandez l'aide du support Tranzila. Pour les tests, Tranzila vous fournit un terminal de test séparé ; saisissez son nom comme nom du terminal.

IP réelle du visiteur : les notifications de paiement sont vérifiées par rapport à l'adresse IP du serveur Tranzila. Si votre boutique se trouve derrière un proxy ou un CDN tel que Cloudflare, le serveur web doit transmettre à PHP l'IP réelle du visiteur (REMOTE_ADDR).

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

Installation

Le téléchargement est un seul fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_tranzila_payment_gateway.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_tranzila_payment_gateway-oc3-(version).ocmod.zip. L'extension ne comporte 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 Tranzila Payment Gateway 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 en forme de 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 le Terminal name (supplier), et le Terminal password (TranzilaPW) si vous utilisez le handshake ou les remboursements.

5. Gardez Notifications activé et vérifiez Trusted IP : ce champ doit contenir les adresses IP depuis lesquelles Tranzila envoie les notifications. Faites confirmer la liste par le support Tranzila. L'URL de notification est envoyée avec chaque paiement, vous n'avez donc rien à copier nulle part.

6. Recommandé : activez le handshake dans le terminal Tranzila, autorisez-y l'IP de votre serveur, puis activez Handshake dans l'extension.

7. Activez Enable/Disable, cliquez sur Save et testez un paiement avec le terminal de test Tranzila.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_tranzila_payment_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension à partir du 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 Tranzila Payment Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence et les paramètres comme aux étapes 3 à 7 pour OpenCart 3. La page des paramètres et ses champs sont les mêmes dans les deux versions.

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

Configuration

Tous les paramètres se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Au-dessus des paramètres, la page vous avertit lorsque le nom du terminal est vide (le mode de paiement est alors masqué au paiement), lorsque les notifications sont désactivées ou que Trusted IP est vide (les commandes payées sont alors mises en attente d'un examen manuel), lorsque le handshake est activé sans mot de passe de terminal (la page de paiement ne peut pas être ouverte) et lorsque la devise par défaut de la boutique n'est pas prise en charge. Sans le droit de modifier l'extension, la page affiche les paramètres mais ne peut pas les enregistrer.

Lors de l'enregistrement, la page ne rejette jamais tout en bloc. Un Title vide ou dépassant 128 caractères, un nom de terminal invalide, une entrée invalide dans Trusted IP, un champ numérique qui n'est pas un nombre entier, ou un Sort Order, un Total, une Geo Zone ou un statut de commande invalide n'est pas enregistré : la page affiche le message dans un bloc rouge au-dessus des paramètres, et le champ reprend sa valeur précédente. Un nombre hors de la plage autorisée est enregistré à la valeur autorisée la plus proche, et la page vous l'indique, par exemple que 5000 est hors de 400–1500 et a été enregistré comme 1500. Tous les autres champs sont enregistrés.

Tranzila

Enable/Disable : Enable Tranzila Payment Gateway active ou désactive le mode de paiement. Par défaut : off.

Title : le nom du mode de paiement que le client voit à la validation de la commande et le titre de la page de paiement. C'est aussi le nom du mode de paiement enregistré dans la commande ; il est donc obligatoire et peut comporter 128 caractères au maximum. Par défaut : Credit Card (Tranzila).

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely with your credit card on the Tranzila payment page.

Sort Order : la position de Tranzila parmi les modes de paiement au moment du paiement. Laissez le champ vide ou saisissez un nombre entier (les valeurs négatives sont acceptées).

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

Total : le montant total de la commande, dans la devise par défaut de la boutique, que la commande doit atteindre avant que Tranzila soit proposé. Laissez vide pour proposer Tranzila quel que soit le montant.

Terminal

Terminal name (supplier) : le nom de votre terminal Tranzila, par exemple myshop. Lettres, chiffres, « - » et « _ » uniquement. Tant qu'il n'est pas saisi, le mode de paiement n'est pas affiché au paiement. Pour les tests, saisissez le nom de votre terminal de test Tranzila.

Terminal password (TranzilaPW) : le mot de passe API du terminal. Il est nécessaire pour le handshake et pour les remboursements depuis la page de la commande.

Refund password (CreditPass) : uniquement si votre terminal exige un mot de passe distinct pour les transactions de crédit (remboursements). Laissez vide sinon.

Les mots de passe enregistrés ne sont jamais réaffichés. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier. Pour supprimer un mot de passe enregistré, cochez Clear saved password on save sous le champ et cliquez sur Save.

Page de paiement

Payment page version : la page Tranzila affichée dans l'iframe.

Payment page language : la langue de la page Tranzila : Site language, hébreu, anglais, russe, espagnol, allemand, français ou japonais. Par défaut : Hebrew. Site language utilise la langue de la boutique du client lorsqu'elle fait partie de ces langues, sinon l'anglais.

iFrame width (px) : de 300 à 1200. Par défaut : 600. Sur les petits écrans, le cadre n'est jamais plus large que la page.

iFrame height (px) : de 400 à 1500. Par défaut : 650.

Max installments : le nombre maximal de versements (tashlumim) que le client peut choisir sur la page de paiement, jusqu'à 36. 0 ou 1 signifie pas de versements. Par défaut : 0. Le terminal doit être autorisé à traiter les versements.

Handshake : verrouille le montant avec un jeton de handshake (recommandé). Avant d'ouvrir la page de paiement, la boutique demande à Tranzila un jeton à usage unique lié au montant, de sorte que le montant ne peut pas être modifié dans le navigateur. Cela nécessite le mot de passe du terminal, l'activation du handshake dans le terminal Tranzila et l'autorisation de l'adresse IP de votre serveur. Par défaut : off.

Confirmation du paiement

Les notifications Tranzila ne sont pas signées. Une commande ne reçoit le statut payé que lorsque la notification provient d'une Trusted IP et que son jeton de page de paiement, sa commande, son terminal, son montant et sa devise correspondent à la page de paiement. Avec le handshake, le jeton doit aussi correspondre. Le retour du client depuis la page de paiement ne marque jamais une commande comme payée.

Notifications : confirme automatiquement les paiements grâce aux notifications Tranzila (URL de notification). Par défaut : on. Lorsque les notifications sont désactivées, un client qui revient d'une page de paiement réussie place la commande en On hold status, et vous confirmez le paiement manuellement après avoir vérifié le terminal Tranzila.

Notification URL : affichée à titre indicatif. Elle ressemble, dans OpenCart 3, à https://your-store/index.php?route=extension/payment/wcp_tranzila_payment_gateway/notify et, dans OpenCart 4, à https://your-store/index.php?route=extension/wcp_tranzila_payment_gateway/payment/wcp_tranzila_payment_gateway.notify. Elle est construite à partir de l'adresse de la boutique de votre installation OpenCart. L'URL est envoyée à Tranzila avec chaque paiement ; vous n'avez donc pas à la saisir dans le terminal Tranzila. Elle fonctionne aussi lorsque la boutique est en mode maintenance (sur OpenCart 4, une action de démarrage de l'extension laisse passer la notification et le retour du client).

Trusted IP : les adresses IP ou plages CIDR des serveurs Tranzila qui envoient les notifications, séparées par des virgules. Par défaut : 80.244.170.7. Faites confirmer la liste actuelle par le support Tranzila. Les notifications provenant d'autres adresses sont rejetées. Si le champ est vide, les notifications ne peuvent pas être vérifiées : un paiement réussi signalé place la commande en On hold status pour un examen manuel, et un refus signalé ne change rien.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'à partir d'une notification Tranzila vérifiée. OpenCart n'a pas de statut On hold : c'est donc le statut que vous choisissez ici qui est utilisé, et une note de commande explique pourquoi. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Order status after payment : le paiement a été confirmé par une notification vérifiée (montant, devise, terminal et jeton concordants). Par défaut : Processing.

On hold status : le paiement nécessite votre examen : le montant, la devise ou le jeton de handshake ne correspondent pas, la notification n'a pas pu être vérifiée (pas de Trusted IP), ou les notifications sont désactivées et le client est revenu d'une page de paiement réussie. Par défaut : Pending. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Refunded status : défini lorsque le paiement est entièrement remboursé depuis la page de la commande. Par défaut : Refunded.

Cancelled order status : l'extension ne le définit pas. Une commande dans ce statut qui est payée plus tard est rouverte avec une note vous invitant à vérifier le stock. Par défaut : Canceled.

Payment error status : l'extension ne le définit pas. Une commande dans ce statut est payée par un paiement Tranzila approuvé ultérieur. Par défaut : Failed.

Avancé

Debug log : enregistre les événements de la page de paiement, des notifications et des remboursements dans tranzila_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs, sur OpenCart 4 : system/storage/logs). Le fichier ne peut pas être ouvert depuis le web ; à 5 Mo, il est déplacé vers tranzila_p_debug.old.log.php. Les avertissements et les erreurs sont toujours enregistrés, même lorsque cette option est désactivée. Les mots de passe, jetons et données clients ne sont jamais écrits. Par défaut : off.

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

Delete data on uninstall : lorsque cette option est activée, la désinstallation de l'extension supprime les paramètres et le journal. Les transactions et remboursements Tranzila sont toujours conservés, car les anciennes commandes en ont besoin. Par défaut : off.

Import / Export

Export : Download JSON enregistre les paramètres dans un fichier JSON. Les mots de passe ne sont pas exportés.

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

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit Card (Tranzila)). À l'étape Confirm Order, le client voit votre description et la mention After you confirm, you will enter your card details on the secure Tranzila payment page. The order is confirmed once Tranzila confirms the payment. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, il est dirigé vers une page de paiement de votre boutique. La page de paiement Tranzila s'ouvre alors dans un iframe, avec le total de la commande dans la devise de la commande, les coordonnées de facturation et une courte liste des produits. La page indique Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". Le lien Choose another payment method se trouve sous le cadre. Si les versements sont autorisés, le client choisit leur nombre sur la page Tranzila. Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc des modes de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de commande.

Chaque affichage de la page de paiement correspond à une nouvelle tentative de paiement, avec son propre jeton (et son propre jeton de handshake). Recharger la page ouvre une nouvelle tentative pour la commande de la même session client ; un lien vers la page de paiement ouvert dans un autre navigateur renvoie au paiement.

Après un paiement réussi, Tranzila renvoie le client et l'ensemble de la fenêtre poursuit son chemin. La commande n'est marquée payée qu'après que Tranzila l'a confirmée par une notification. La commande reçoit ensuite son statut de la manière habituelle d'OpenCart, avec les e-mails de commande habituels et la mise à jour du stock. Lorsqu'une commande en attente est payée plus tard, le client reçoit l'e-mail concernant le nouveau statut de sa commande. Si la notification est déjà arrivée, le client voit la page de succès de commande d'OpenCart avec Your payment with Tranzila has been received. Si la commande est en attente d'examen, la page affiche Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. Si la notification n'est pas encore arrivée, une page Payment confirmation affiche Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. avec les boutons Check again et Back to checkout.

Si le paiement est refusé ou annulé, le client revient au paiement avec le message The payment was not completed. You have not been charged — please try again or choose another payment method. Lorsque Tranzila communique un code de réponse, la raison et le code sont ajoutés, par exemple que la carte est expirée. Le panier est conservé et la commande reste sans statut. Sur OpenCart 4, ce message s'affiche au-dessus de la page de validation de la commande. OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 met à jour la commande de la page de validation ; un panier déjà payé par l'une de ces commandes n'est pas débité à nouveau. Toute modification du panier, y compris une nouvelle quantité, compte comme un nouveau panier qui nécessite son propre paiement.

OpenCart 4 conserve la commande dans le tunnel de paiement jusqu'à l'affichage de la page de succès. Après un paiement refusé, le client paie à nouveau la même commande avec une nouvelle tentative de paiement. Si cette commande a été fermée entre-temps (par exemple si vous l'avez annulée), ou si elle a été payée pour un panier modifié depuis, le client est renvoyé vers la page de paiement avec This order can no longer be paid. Please confirm your order again., et le prochain Confirm Order paie une nouvelle commande.

Si la page de paiement ne peut pas être ouverte, par exemple lorsque le handshake échoue, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, tel que Could not connect to Tranzila. Please try again in a moment. La raison technique est écrite dans le journal.

L'extension ne prend en charge que les paiements par carte uniques, sur la page Tranzila. Elle ne gère ni cartes ni jetons enregistrés, ni abonnements, ni autorisation et capture séparées (J5), ni boutons Bit, Apple Pay ou Google Pay propres (ce que votre page de paiement Tranzila propose est affiché dans l'iframe), ni factures Tranzila.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé vers la page de paiement et n'a pas payé, le paiement a été refusé, ou la notification Tranzila n'est pas encore arrivée. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders. Sur OpenCart 4.1, une telle commande peut aussi avoir le statut Voided, que OpenCart définit lorsque l'étape de confirmation est à nouveau affichée ; l'extension la compte comme une commande sans statut.

Statut de commande après paiement (Processing par défaut) : le paiement a été confirmé par une notification vérifiée. Une note affiche le montant, la transaction Tranzila (index), le numéro d'autorisation et le nombre de versements, le cas échéant.

On hold status (Pending par défaut) : le paiement a été signalé mais n'a pas été accepté automatiquement : le montant, la devise ou le jeton de handshake ne correspondaient pas ; la notification n'a pas pu être vérifiée parce que Trusted IP est vide ; ou les notifications sont désactivées et le client est revenu d'une page de paiement réussie. La note explique la raison. Vérifiez le paiement dans le terminal Tranzila et modifiez le statut manuellement.

Refunded status (Refunded par défaut) : le paiement a été entièrement remboursé via l'extension.

Si un paiement arrive pour une commande en statut d'attente, annulée ou en erreur de paiement, la commande reçoit le Order status after payment ; une commande annulée reçoit en plus une note vous demandant de vérifier le stock avant expédition. Si un second paiement arrive pour une commande déjà payée ou remboursée, ou pour une autre commande d'un panier déjà payé, la commande n'est pas modifiée. Une note sur la commande payée vous demande de la vérifier et de rembourser le doublon dans le terminal Tranzila. Les notifications répétées de la même transaction sont ignorées.

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

Onglet VibeFox Tranzila Payment Gateway

Dans Sales > Orders, ouvrez une commande payée avec Tranzila. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Tranzila Payment Gateway affiche la Transaction (index), l'Authorization, le Terminal, le Status, les montants Paid / refunded, le nombre de Installments, le formulaire de remboursement, l'historique des remboursements, toutes les Payment pages of the cart avec leur résultat et les Tranzila notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox Tranzila Payment Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un Reason (optional), puis cliquez sur Refund via Tranzila. Confirmez la question Refund this amount via Tranzila? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier les commandes (sale/order dans System > Users > User Groups). Le remboursement est effectué sous forme de transaction de crédit Tranzila sur le paiement d'origine, sur le terminal qui l'a encaissé, pour le montant et dans la devise réellement débités par Tranzila. Ainsi, après un écart de montant ou de devise, vous pouvez rembourser jusqu'à ce que le client a réellement payé, et non jusqu'au total de la commande.

Le formulaire est disponible lorsque le mot de passe du terminal est défini et que la commande a une transaction Tranzila confirmée. Sinon, l'onglet indique la raison, par exemple Refunds need the terminal password (TranzilaPW) in the gateway settings. Une commande payée sur un autre terminal que celui des paramètres actuels (par exemple un terminal de test) ne peut pas être remboursée depuis la page de la commande ; remboursez-la dans ce terminal Tranzila.

Si Tranzila n'accepte pas le remboursement, l'onglet affiche l'erreur, par exemple Tranzila declined the refund avec le code et sa signification, et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes avec la transaction de crédit Tranzila. Un remboursement total définit la commande en Refunded status sans informer le client et sans remettre les produits en stock, comme un changement de statut manuel. Un remboursement partiel ne modifie pas le statut.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Tranzila. Les remboursements effectués dans le terminal Tranzila ne sont pas signalés à la boutique. Mettez la commande à jour manuellement si nécessaire.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Tranzila Payment Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > 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) et les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-tranzila 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é un emplacement 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 pour un seul domaine : l'adresse de la boutique issue de la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, Tranzila n'est pas affiché aux clients au moment du paiement. Si un paiement est tout de même 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é. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, 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 par la notification Tranzila et le retour à la boutique, 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é à nouveau automatiquement lorsque vous ouvrez le Dashboard ou 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

Tranzila n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que Terminal name (supplier) est rempli et que la devise du client est ILS, USD, EUR ou GBP. La page des paramètres affiche un avertissement lorsque le nom du terminal manque ou que la devise par défaut n'est pas prise en charge. Vérifiez également que l'adresse de paiement se situe dans la Geo Zone choisie et que la commande atteint le Total défini dans les paramètres.

Le paiement a abouti, mais la commande reste sans statut : la notification n'est pas arrivée ou a été rejetée. Vérifiez que Notifications est activé et que Trusted IP contient les adresses depuis lesquelles Tranzila envoie les notifications. Les erreurs sont toujours écrites dans le journal ; consultez le champ Log sur la page de l'extension. Le message indiquant qu'une IP ne figure pas dans la liste Trusted IP signifie qu'il faut corriger le réglage Trusted IP ou la configuration de votre proxy : derrière un proxy ou un CDN, le serveur web doit transmettre à PHP l'IP réelle du visiteur. Pour les développeurs dont la boutique se trouve derrière un reverse proxy de confiance, l'extension déclenche l'événement OpenCart wcp_tranzila_payment_gateway/remote_ip pour définir l'IP.

La notification répond Forbidden : elle provient d'une adresse IP absente de Trusted IP.

La notification répond Bad request ou Not found : la commande, le jeton de la page de paiement, le terminal ou l'index de transaction de la notification ne correspondent à aucune page de paiement de cette boutique.

La notification répond Accepted for manual review : Trusted IP est vide, la notification n'a donc pas pu être vérifiée. Un paiement réussi place la commande en attente. Renseignez Trusted IP pour confirmer les paiements automatiquement.

La notification répond Busy, retry : le panier é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. Le journal indique la raison. Vérifiez le paiement dans le terminal Tranzila.

Certaines commandes sont en statut d'attente : lisez les notes de l'onglet VibeFox Tranzila Payment Gateway. Le montant, la devise ou le jeton de handshake ne correspondaient pas, ou la notification n'a pas pu être vérifiée (Trusted IP vide, ou notifications désactivées). Vérifiez le paiement dans le terminal Tranzila et modifiez le statut manuellement.

La page de paiement ne s'ouvre pas avec le handshake activé : vérifiez le nom du terminal et le mot de passe du terminal, que le handshake est activé dans le terminal Tranzila et que l'adresse IP de votre serveur y est autorisée. Le journal indique la raison.

Les remboursements échouent : les remboursements nécessitent le Terminal password (TranzilaPW). Certains terminaux exigent aussi un mot de passe de crédit distinct ; saisissez-le dans Refund password (CreditPass). Les commandes payées sur un autre terminal doivent être remboursées dans ce terminal. Si la réponse de Tranzila est inattendue, l'onglet indique que le remboursement n'a pas été confirmé : vérifiez le terminal Tranzila avant de réessayer. Sans le droit de modifier les commandes, l'onglet affiche You do not have permission to refund orders.

Autres devises : l'extension ne prend en charge que ILS, USD, EUR et GBP.

Pour les développeurs : avant l'affichage de la page de paiement, l'extension déclenche l'événement OpenCart wcp_tranzila_payment_gateway/payment_page_params avec les champs de la page de paiement et de la commande.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Tranzila Payment Gateway. 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 reviennent à leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laisse passer la notification et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres paramètres (titre, description, terminal, mots de passe, page de paiement, confirmation du paiement, journalisation) et le journal sont supprimés. Si l'option est désactivée, ils sont conservés pour une réinstallation ultérieure. Les transactions et remboursements Tranzila sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

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

Tranzila est une marque de commerce de son titulaire. Cette extension n'est pas affiliée à Tranzila et n'est pas approuvée par Tranzila.