VibeFox Datatrans 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.

Compte Datatrans : vous avez besoin de l'identifiant marchand (merchant ID), du mot de passe d'API serveur à serveur et, recommandé, de la clé de signature HMAC-SHA256 pour les webhooks. Les identifiants sandbox proviennent de la Web Admin sandbox de Datatrans (admin.sandbox.datatrans.com), les identifiants de production de la Web Admin de production (admin.datatrans.com). Le sandbox et la production sont des comptes Datatrans distincts, avec des identifiants marchands et des clés différents.

Boutique accessible : Datatrans envoie les webhooks depuis ses propres serveurs ; votre boutique doit donc être accessible depuis Internet.

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

Installation

Le téléchargement est un fichier ZIP unique contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_datatrans_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_datatrans_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_datatrans_gateway-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD ; Extensions > Modifications n'a donc pas besoin d'être actualisé. Au lieu de passer par 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 Datatrans 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 réglages. 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 sandbox de la Web Admin sandbox de Datatrans (voir Configuration).

5. Activez Enable/Disable et cliquez sur Save. Effectuez un paiement test en mode sandbox. Quand tout fonctionne, saisissez les identifiants de production et désactivez Sandbox mode.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_datatrans_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension 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 Datatrans Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Saisissez la clé de licence et les identifiants Datatrans, et testez le paiement comme aux étapes 3 à 5 pour OpenCart 3. La page de configuration et ses champs sont identiques dans les deux versions. Seule l'URL du webhook diffère (voir Configuration).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode sandbox activé. L'URL du webhook est envoyée à Datatrans à chaque transaction ; vous n'avez donc rien à configurer.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre toute la page. Lorsque le mode de paiement est activé mais que l'environnement en cours n'a ni identifiant marchand ni mot de passe d'API, la page affiche Datatrans is hidden at checkout until these settings are filled in: suivi des champs manquants. Tant que le mode sandbox est activé, la page affiche Sandbox mode is on: payments go to the Datatrans sandbox, no real money is charged. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, Title ne doit pas être vide ni dépasser 128 caractères, Sort Order doit être un nombre entier, Total doit être un nombre supérieur ou égal à 0, et la zone géographique ainsi que les statuts de commande doivent exister. Sinon, rien n'est enregistré et la page affiche l'erreur. Une clé de signature qui n'est pas une chaîne hexadécimale n'est pas enregistrée : la valeur précédente est conservée, les autres réglages sont enregistrés, et la page affiche un avertissement qui nomme le champ concerné.

Datatrans

Enable/Disable : Enable Datatrans Payment active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement que le client voit à la page de paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Datatrans. Obligatoire, jusqu'à 128 caractères.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely via Datatrans.

Sandbox mode : utilise le sandbox de Datatrans : paiements de test, aucun argent réel. Ce commutateur change à la fois les serveurs de Datatrans et les identifiants utilisés pour les nouveaux paiements. Par défaut : activé. Désactivez-le pour encaisser de vrais paiements. Tant qu'il est activé, les clients voient Sandbox mode: no real payment is taken. à l'étape Confirm Order. Les remboursements et les captures utilisent toujours l'environnement dans lequel le paiement a été effectué, quelle que soit la position de ce commutateur.

Sort Order : la position de Datatrans parmi les modes de paiement à la page de paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer Datatrans uniquement pour les adresses de facturation 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, que doit atteindre une commande avant que Datatrans ne soit proposé. Laissez le champ vide pour proposer Datatrans quel que soit le montant.

Identifiants sandbox

Copiez-les depuis la Web Admin sandbox de Datatrans (admin.sandbox.datatrans.com ; la page contient le lien). La clé de signature se trouve dans les paramètres de sécurité de cette interface.

Sandbox merchant ID : l'identifiant marchand de votre compte sandbox.

Sandbox API password : le mot de passe d'API serveur à serveur du compte sandbox.

Sandbox HMAC sign key : la clé hexadécimale utilisée pour vérifier l'en-tête Datatrans-Signature des webhooks. Sans elle, chaque webhook est vérifié de nouveau auprès de l'API de statut de Datatrans.

Identifiants de production

Copiez-les depuis la Web Admin de production de Datatrans (admin.datatrans.com).

Production merchant ID : l'identifiant marchand de votre compte de production.

Production API password : le mot de passe d'API serveur à serveur du compte de production.

Production HMAC sign key : la clé hexadécimale utilisée pour vérifier l'en-tête Datatrans-Signature des webhooks de production. Sans elle, chaque webhook est vérifié de nouveau auprès de l'API de statut de Datatrans.

Les mots de passe et clés de signature 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 si vous voulez la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ, puis cliquez sur Save.

URL du webhook

La section affiche l'URL du webhook de votre boutique. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_datatrans_gateway/webhook, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_datatrans_gateway/payment/wcp_datatrans_gateway.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'extension envoie cette URL à Datatrans à chaque transaction ; vous n'avez donc rien à saisir ailleurs. Vous pouvez aussi la saisir dans les paramètres de webhooks de la Web Admin de Datatrans, pour recevoir les mises à jour des captures et annulations effectuées là-bas ; copiez-la exactement telle que les paramètres l'affichent. Les remboursements effectués dans la Web Admin de Datatrans ne sont pas reflétés dans la commande.

Le webhook signale l'état de la transaction. L'extension agit selon ces états :

Avec une clé de signature HMAC, chaque webhook est vérifié grâce à son en-tête Datatrans-Signature, avec la clé de signature de l'environnement dans lequel le paiement a été effectué. Les webhooks sans signature valide sont rejetés. Sans clé de signature, l'extension ne fait pas confiance au contenu du webhook et vérifie chaque webhook auprès de l'API de statut de Datatrans. Sans webhook, une commande ne reçoit son statut que lorsque le client revient dans la boutique après avoir payé.

Traitement du paiement

Auto settle : capture (règle) les paiements immédiatement. Si cette option est désactivée, les paiements sont seulement autorisés : la commande est mise en attente, et vous la capturez plus tard avec Capture Datatrans payment dans l'onglet de la commande, ou vous la libérez avec Cancel Datatrans authorization. Par défaut : activé.

OpenCart crée la commande à l'étape Confirm Order sans statut (commande manquante). La commande ne reçoit un statut qu'une fois que Datatrans a confirmé le paiement. Un paiement échoué ou annulé laisse la commande sans statut, et le panier est conservé. Chacun des champs ci-dessous présente les statuts de commande de votre OpenCart.

Order status after payment : le statut de la commande une fois le paiement réglé, et lorsque son montant et sa devise correspondent. Par défaut : Processing.

Datatrans payment on hold : paiements uniquement autorisés (Auto settle désactivé), écarts de montant ou de devise, et paiements arrivant après l'annulation de la commande. Une note explique la raison. Par défaut : Pending, car OpenCart n'a pas de statut On hold. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Authorization canceled : défini lorsque l'autorisation est libérée avec Cancel Datatrans authorization ou dans la Web Admin de Datatrans. Par défaut : Canceled.

Refunded : défini après un remboursement total du paiement depuis la page de la commande. Par défaut : Refunded.

Avancé

Logging : écrit les événements de paiement et les appels API dans datatrans_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web et, à 5 Mo, il est déplacé vers datatrans_p_debug.old.log.php. Les erreurs sont toujours journalisées, même lorsque ce commutateur est désactivé. Aucune clé, donnée de carte ni donnée client n'est écrite. 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 réglages du module et le journal. Les enregistrements de paiement Datatrans des commandes (transactions, remboursements) sont conservés. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les mots de passe et les clés de signature ne sont pas exportés.

Import : collez le JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les mots de passe et clés de signature enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Datatrans). À l'étape Confirm Order, le client voit votre description et la note You will be redirected to the Datatrans payment page to complete the payment securely. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée une transaction Datatrans pour le total de la commande dans la devise de la commande, avec le numéro de commande OpenCart comme référence, et envoie le client sur la page de paiement de Datatrans. La page s'ouvre en allemand, anglais, français ou italien lorsque la langue de la boutique est l'une de celles-ci. Le client y paie avec l'un des modes activés dans votre compte Datatrans. Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc de mode de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'après confirmation de Datatrans : par le webhook, ou par une requête côté serveur à l'API de statut de Datatrans lorsque le client revient. L'adresse de retour contient un jeton aléatoire de la tentative de paiement, et cette adresse elle-même n'est jamais considérée comme fiable. La commande reçoit ensuite son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour du stock, et le client voit la page de confirmation de commande d'OpenCart avec Your payment with Datatrans has been received. Pour un paiement uniquement autorisé, la page affiche Your payment with Datatrans has been authorized. The amount will be charged when your order is processed. Si Datatrans n'a pas encore confirmé le paiement, une page Payment confirmation affiche Your payment is being confirmed by Datatrans. You will receive an e-mail as soon as it is confirmed. Please do not pay again. avec les boutons Check again et Back to checkout ; le webhook définit le statut de la commande dès son arrivée. Sur OpenCart 4, le navigateur n'envoie pas la session de la boutique lorsque Datatrans renvoie le client ; l'extension affiche donc d'abord une courte page qui rouvre la même adresse de retour depuis votre boutique : le client conserve son panier et sa connexion.

Si le client annule sur la page de Datatrans, il revient à la page de paiement avec The payment was canceled. You can try again or choose another payment method. Si le paiement a échoué, le message est The payment was not completed. Please try again or choose another payment method. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement. Le panier est conservé. OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order ; OpenCart 4 conserve une commande pour le paiement et la met à jour, et une nouvelle tentative est une nouvelle transaction Datatrans de la même commande. Avant qu'un nouveau paiement ne démarre, les transactions Datatrans encore ouvertes des commandes précédentes du même panier sont vérifiées : une transaction payée ou autorisée est confirmée au lieu de lancer un nouveau paiement, et une transaction ouverte est annulée chez Datatrans. Un panier n'est payé qu'une fois : si une autre commande du même panier est déjà payée ou autorisée, aucun nouveau paiement n'est lancé et le client est redirigé vers la page de succès. Si un paiement pour une autre commande d'un panier déjà payé arrive tout de même, cette commande reste sans statut et la commande payée reçoit une note vous invitant à vérifier le doublon et à le rembourser dans Datatrans.

OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès. Si cette commande a été fermée entre-temps sans paiement (par exemple annulée, aussi après que vous avez annulé une autorisation, ou remboursée), Confirm Order ou le retour depuis Datatrans renvoie le client au paiement avec Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., et le Confirm Order suivant paie une nouvelle commande du panier. Si la commande est déjà payée et que le panier a changé depuis (autres produits ou quantités), le client est renvoyé au paiement, et le panier modifié reçoit une nouvelle commande et son propre paiement ; le même panier passe à la page de succès sans nouveau paiement.

Si Datatrans ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec le message The payment could not be started. Please try again or choose another payment method. La raison technique est écrite dans le journal.

Le webhook fonctionne aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute une action de démarrage qui laisse passer le webhook et le retour du client.

L'extension prend en charge les paiements uniques sur la page de paiement de Datatrans. Elle ne gère pas les cartes ou alias enregistrés, les abonnements, Lightbox ni Secure Fields sur votre site, le choix des modes de paiement dans les réglages, ni la capture partielle d'une autorisation.

Commandes et remboursements

Statuts de commande

No status (missing order) : le client a été envoyé vers Datatrans et n'a pas payé, le paiement a échoué ou a été annulé, ou Datatrans ne l'a pas encore confirmé. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status défini sur Missing Orders.

Order status after payment (default Processing) : le paiement a été réglé. Une note affiche le montant, le mode de paiement, l'identifiant de transaction Datatrans, l'environnement et la manière dont il a été confirmé (webhook ou retour).

Datatrans payment on hold after an authorization (default Pending) : Auto settle est désactivé et le paiement n'est qu'autorisé. Capturez-le ou annulez-le dans l'onglet de la commande.

Datatrans payment on hold after payment : Datatrans a signalé un montant ou une devise différent du total de la commande, ou le paiement est arrivé après l'annulation de la commande. La note l'explique. Vérifiez la transaction dans la Web Admin de Datatrans, puis exécutez la commande ou remboursez le paiement.

Authorization canceled (default Canceled) : l'autorisation a été libérée, dans l'onglet de la commande ou dans la Web Admin de Datatrans.

Refunded (default Refunded) : le paiement a été intégralement remboursé via l'extension.

Si un second paiement arrive pour une commande déjà payée ou autorisée, la commande n'est pas modifiée. Une note vous invite à vérifier et à rembourser le doublon dans Datatrans. Une transaction échouée ou annulée ne rétrograde jamais une commande payée. Un paiement pour une commande déjà remboursée ajoute seulement une note.

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

Onglet VibeFox Datatrans Gateway

Dans Sales > Orders, ouvrez une commande payée avec Datatrans. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Datatrans Gateway affiche le Transaction ID avec une étiquette Sandbox pour les paiements sandbox, le Status Datatrans, le Payment method, le Amount, les montants Paid / refunded, les boutons de capture et d'annulation ou le formulaire de remboursement, l'historique des remboursements et les Datatrans notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension. Ses actions nécessitent le droit de modifier l'extension (à définir dans System > Users > User Groups).

Capture et annulation

Pour un paiement uniquement autorisé, l'onglet affiche Capture Datatrans payment et Cancel Datatrans authorization. La capture règle le paiement pour le total actuel de la commande, qui ne doit pas dépasser le montant autorisé ; la commande passe ensuite à Order status after payment. L'annulation libère l'autorisation et place la commande en Authorization canceled. Les deux actions sont envoyées à l'environnement du paiement. Si Datatrans les refuse, l'onglet affiche l'erreur et une note est ajoutée.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est pré-rempli), éventuellement un Reason (optional), puis cliquez sur Refund via Datatrans. Confirmez la question Refund this amount through Datatrans? This cannot be undone. Les remboursements totaux et partiels sont pris en charge, dans la limite du montant réellement débité par Datatrans moins les remboursements précédents. Le remboursement est envoyé à l'environnement du paiement ; l'identifiant marchand et le mot de passe d'API de cet environnement doivent donc être renseignés. Un remboursement relancé n'est pas crédité deux fois. Si Datatrans n'accepte pas le remboursement, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec l'identifiant de la transaction de remboursement Datatrans. Un remboursement total fait passer la commande en Refunded sans en informer le client et sans remettre les produits en stock, comme un changement manuel de statut. Un remboursement partiel ne modifie pas le statut.

Les remboursements sont disponibles une fois que Datatrans a réglé le paiement. Un paiement uniquement autorisé est capturé ou annulé à la place, et une autorisation dont le montant ne correspond pas ne peut être remboursée qu'une fois réglée.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Datatrans. Les remboursements effectués dans la Web Admin de Datatrans ne sont pas enregistrés dans OpenCart.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Datatrans Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit, au-dessus des réglages. 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 retirer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-datatrans 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-le dans votre compte vibefox.net.

Sans clé active, Datatrans n'est pas affiché aux clients à 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. 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 concerné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 l'assistance 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

Datatrans n'apparaît pas à la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé et que l'environnement en cours possède son identifiant marchand et son mot de passe d'API : les champs sandbox en mode sandbox, les champs de production sinon. La page des réglages liste les champs manquants. Vérifiez aussi que l'adresse de facturation se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages.

Le paiement a abouti, mais la commande reste sans statut : Datatrans n'a pas pu atteindre l'URL du webhook et le client n'est pas revenu dans la boutique. Vérifiez que la boutique est accessible depuis Internet et qu'aucun pare-feu ne bloque les requêtes vers l'URL du webhook. Vérifiez que la clé de signature des réglages appartient à l'environnement du paiement. Consultez le champ Log sur la page de l'extension.

Le webhook répond Invalid signature : la clé de signature HMAC des réglages ne correspond pas à celle de la Web Admin de Datatrans, ou appartient à l'autre environnement. Copiez de nouveau la clé.

Le webhook répond Not configured ou Verification failed : le webhook devait être vérifié auprès de l'API de statut de Datatrans, mais les identifiants de cet environnement sont manquants, ou Datatrans n'a pas répondu. Datatrans renouvelle le webhook.

Le webhook répond Busy, retry : la commande était en cours de confirmation par une autre requête au même moment, ou le statut de la commande n'a pas pu être défini. Datatrans renouvelle le webhook. Le journal indique la raison.

L'URL du webhook affiche Method not allowed dans le navigateur : c'est normal. L'URL n'accepte que les requêtes provenant de Datatrans.

La clé de signature HMAC n'est pas enregistrée : la clé doit être une chaîne hexadécimale. Copiez-la de nouveau depuis la Web Admin de Datatrans.

Le client voit Datatrans payments are not configured yet : l'identifiant marchand ou le mot de passe d'API de l'environnement en cours est manquant.

Le client voit The payment could not be started : consultez le champ Log. Un identifiant marchand ou un mot de passe d'API incorrect, ou des identifiants de l'environnement erroné, sont les causes habituelles.

Le client voit We could not verify the payment : l'adresse de retour ne correspondait à aucune tentative de paiement de la commande. Si de l'argent a été débité, le webhook définit tout de même le statut de la commande.

La commande est en statut de vérification après le paiement : lisez les Datatrans notes dans l'onglet de la commande (voir Statuts de commande), puis exécutez la commande ou remboursez le paiement.

La capture est refusée : le total de la commande est supérieur au montant autorisé. Datatrans ne peut pas régler plus que ce qui a été autorisé.

Aucun bouton de capture ni formulaire de remboursement dans l'onglet : l'onglet indique la raison : le paiement n'est pas encore réglé, il est entièrement remboursé, votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou les identifiants de l'environnement du paiement sont manquants.

Le remboursement ou la capture échoue avec un message sur des identifiants manquants : le paiement a été effectué dans l'autre environnement, et son identifiant marchand ou son mot de passe d'API n'est pas renseigné. Saisissez-les et réessayez.

Pour les développeurs : avant la création de la transaction Datatrans, l'extension déclenche l'événement OpenCart datatrans_p_init_request avec le corps de la requête et la commande.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Datatrans Gateway. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres réglages de l'extension : Enable/Disable, Sort Order, Geo Zone, Total et les quatre statuts de commande de la section Payment processing, qui reprennent 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 Datatrans en mode maintenance). Si Delete data on uninstall est activé, les autres réglages du module (titre, description, mode sandbox, identifiants, auto settle, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les transactions et remboursements Datatrans sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées ou capturées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

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

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