Retour

VibeFox dLocal 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 dLocal Go : vous avez besoin de la clé API et du secret API de votre compte dLocal Go, depuis la page Payment integration du tableau de bord dLocal Go : dashboard-sbx.dlocalgo.com pour le sandbox, dashboard.dlocalgo.com pour la production. Le sandbox et la production utilisent des identifiants différents. L'extension fonctionne uniquement avec dLocal Go, et non avec l'API entreprise de dLocal Payments.

Devises et pays : l'extension ne les limite pas. dLocal Go décide quels moyens de paiement proposer selon le pays du client et la devise de la commande, en fonction de votre compte dLocal Go.

Boutique accessible : dLocal Go envoie les notifications de paiement et de remboursement depuis ses propres serveurs ; les URL de notification doivent donc être accessibles depuis Internet en HTTPS.

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 pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_dlocal_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_dlocal_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_dlocal_payment-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 dLocal 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 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 la clé API et le secret API du sandbox et, pour les paiements réels, ceux de la production. Choisissez le Environment (voir Configuration).

5. Activez Enable/Disable et cliquez sur Save. Effectuez un paiement test dans le sandbox, puis passez Environment sur Production.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_dlocal_payment.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 dLocal Payment, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Saisissez la clé de licence et les identifiants dLocal Go, 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. Seules les URL de notification diffèrent (voir Notifications (IPN)).

Il n'y a rien à configurer dans le tableau de bord dLocal Go : les URL de notification et de retour sont transmises à chaque paiement et à chaque remboursement. Une nouvelle installation démarre avec le moyen de paiement désactivé et le sandbox sélectionné.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox dLocal Payment > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre toute la page. Tant que la clé API et le secret de l'environnement sélectionné ne sont pas saisis, la page vous avertit que le moyen de paiement est masqué au paiement, par exemple : Enter the sandbox API key and secret: until then the payment method is hidden at checkout. Tant que le sandbox est sélectionné et que le moyen de paiement est activé, elle affiche Sandbox mode is active: payments are simulated, no 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 égal ou supérieur à 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. Si le moyen de paiement est activé sans la clé et le secret de l'environnement sélectionné, les réglages sont enregistrés avec l'avertissement ci-dessus.

dLocal Go

Enable/Disable : Enable dLocal Go active ou désactive le moyen de paiement. Par défaut : désactivé.

Title : le nom du moyen de paiement que le client voit au moment du paiement. C'est aussi le nom du moyen de paiement enregistré dans la commande. Par défaut : dLocal Go. Obligatoire.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Payez par carte locale, virement bancaire ou en espèces via dLocal Go.

Sort Order : la position de dLocal Go parmi les moyens de paiement proposés au moment du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer dLocal Go 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 total du panier, dans la devise par défaut de la boutique, qu'une commande doit atteindre pour que dLocal Go soit proposé. Laissez le champ vide pour proposer dLocal Go quel que soit le montant.

Identifiants API

Copiez la clé API et le secret API depuis le tableau de bord dLocal Go, Payment integration : dashboard-sbx.dlocalgo.com (sandbox) ou dashboard.dlocalgo.com (production). La section renvoie vers les deux tableaux de bord.

Environment : les identifiants utilisés et les serveurs dLocal Go sollicités pour les nouveaux paiements.

Sandbox (test): paiements de test avec les identifiants du sandbox (par défaut).
Production: paiements réels avec les identifiants de production.

Les remboursements et les notifications d'un paiement utilisent toujours les identifiants de l'environnement dans lequel il a été effectué ; conservez donc les identifiants de l'autre environnement tant que ses paiements sont encore ouverts ou peuvent être remboursés.

Sandbox API Key : votre clé API du sandbox dLocal Go.

Sandbox API Secret : votre secret API du sandbox dLocal Go.

Production API Key : votre clé API de production dLocal Go.

Production API Secret : votre secret API de production dLocal Go.

Les clés et secrets enregistrés ne sont jamais réaffichés. Le champ reste vide et affiche Enregistré : laissez vide pour le conserver. Saisissez une nouvelle valeur uniquement si vous souhaitez la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value sous le champ et cliquez sur Save.

Paiement

Default country : dLocal Go affiche les moyens de paiement du pays du client, tiré de l'adresse de facturation, puis de l'adresse de livraison. Ce pays est utilisé lorsque la commande n'en a aucun des deux. La liste affiche les pays de votre boutique. Par défaut : Uruguay.

Auto-complete orders : donne aux commandes payées le statut Complete Order Status au lieu du Paid Order Status. Par défaut : désactivé.

Notifications (IPN) : les notifications informent votre boutique qu'un paiement ou un remboursement a changé. L'extension transmet les URL de notification à dLocal Go à chaque paiement et à chaque remboursement ; il n'y a donc rien à configurer dans le tableau de bord dLocal Go. Ce champ affiche les deux URL, construites à partir de l'adresse de la vitrine de votre installation OpenCart :

Payments : sur OpenCart 3, de la forme https://your-store/index.php?route=extension/payment/wcp_dlocal_payment/webhook, et sur OpenCart 4, https://your-store/index.php?route=extension/wcp_dlocal_payment/payment/wcp_dlocal_payment.webhook.
Refunds : sur OpenCart 3, de la forme https://your-store/index.php?route=extension/payment/wcp_dlocal_payment/refundwebhook, et sur OpenCart 4, https://your-store/index.php?route=extension/wcp_dlocal_payment/payment/wcp_dlocal_payment.refundwebhook.

Les notifications sont vérifiées avec votre secret API (HMAC-SHA256). Les notifications sans signature valide sont rejetées. Une notification doit être signée avec les identifiants de l'environnement dans lequel le paiement a été effectué. Ensuite, le statut, le montant et la devise du paiement sont toujours relus depuis l'API dLocal Go ; le contenu de la notification n'est pas considéré comme fiable. Sans notifications, une commande ne reçoit son statut que lorsque le client revient dans la boutique.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'après que dLocal Go a confirmé le paiement. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Paid Order Status : le statut de la commande après un paiement confirmé. Par défaut : En cours.

Complete Order Status : le statut de la commande après un paiement confirmé lorsque Auto-complete orders est activé. Par défaut : Terminée.

On Hold (Review) Status : les paiements dont le montant ou la devise ne correspondent pas à la commande, ou qui arrivent après l'annulation de la commande, reçoivent ce statut et une note expliquant la raison. Par défaut : En attente, 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.

Refunded Status : défini une fois le paiement entièrement remboursé depuis la page de la commande. Par défaut : Remboursée.

Avancé

Debug log : écrit les requêtes et notifications dLocal Go dans dlocal_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 un fichier de sauvegarde. Les identifiants API et les données personnelles ne sont pas journalisés. Les erreurs et les avertissements sont toujours écrits ; les autres entrées uniquement tant que cette option est activée. 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 : lorsque l'option est activée, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les données de paiement des commandes (paiements et remboursements dLocal) sont toujours conservées, afin que les commandes existantes continuent de fonctionner. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les identifiants API ne sont pas exportés.

Import : collez le JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les identifiants API enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le moyen de paiement (par défaut dLocal Go). À l'étape Confirm Order, le client voit votre description et la note You will be redirected to the dLocal Go checkout page. En mode sandbox, il voit aussi Sandbox mode: no real payment is made. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée un paiement dLocal Go pour le total de la commande dans la devise de la commande, avec le pays, le nom, l'adresse e-mail et le téléphone du client, puis envoie le client sur la page de paiement dLocal Go. Là, le client paie avec un moyen de paiement de son pays. Sur la page dLocal Go, le paiement apparaît comme Order # suivi du numéro de commande. Sur OpenCart 4, le client choisit le moyen de paiement avec le bouton Choose du bloc de moyen de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement. Si la boutique ne demande pas d'adresse de facturation (valeur par défaut d'OpenCart 4), le pays de l'adresse de livraison et le nom du client sont utilisés.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée comme payée qu'après confirmation par dLocal Go : par la notification signée ou par une requête côté serveur vers l'API dLocal Go lorsque le client revient. L'adresse de retour contient un jeton aléatoire de la tentative de paiement. 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, et le client voit la page de réussite de commande d'OpenCart avec Your payment with dLocal Go has been received. Si la commande a été placée au statut de vérification, la page affiche Your dLocal Go payment has been received and is being reviewed by the store. You will be informed when your order is confirmed. Si dLocal Go n'a pas encore confirmé le paiement (par exemple un bon en espèces pas encore payé, ou si dLocal Go n'a pas pu être joint), une page Payment confirmation demande au client de ne pas payer à nouveau et propose Check again et Back to checkout. La commande reçoit son statut dès que dLocal Go confirme le paiement. Sur OpenCart 4, le navigateur n'envoie pas la session de la boutique lorsque dLocal Go 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 quitte la page dLocal Go sans payer, il revient au paiement et voit The payment at dLocal Go was not completed. You can try again or choose another payment method. Si le paiement a été refusé ou a expiré, le message est Your dLocal payment was not completed: it was declined or it expired. 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é. Chaque clic sur Confirm Order crée un nouveau paiement dLocal Go. OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée ; OpenCart 4 conserve une commande pour le paiement et la met à jour, si bien que le nouveau paiement appartient à la même commande. Un ancien lien de paiement peut encore être payé et confirme sa commande. Avant qu'un nouveau paiement ne démarre, les paiements ouverts de la même commande et de la même session du client (dernières 24 heures) sont relus depuis dLocal Go : si l'un est payé, sa commande est confirmée et le client accède à la page de réussite sans avoir à payer une seconde fois.

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 annulée ou remboursée), Confirm Order ou le retour depuis dLocal Go 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 dLocal Go ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec un bref message, par exemple dLocal could not start the payment: suivi de la raison donnée par dLocal. Cela se produit aussi lorsque le pays du client et la devise de la commande ne sont pas activés dans votre compte dLocal Go. Si dLocal Go rejette vos identifiants, le client voit This payment method is temporarily unavailable. Please choose another payment method or contact us. La raison technique est écrite dans le journal.

Les notifications fonctionnent 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 les notifications et le retour du client.

L'extension prend uniquement des paiements ponctuels sur la page dLocal Go. Elle n'a ni formulaire de carte sur votre site, ni cartes enregistrées, ni abonnements, ni autorisation et capture séparées.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé vers dLocal Go et n'a pas payé, le paiement a été refusé ou a expiré, ou il est toujours en attente chez dLocal Go. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Paid Order Status (par défaut En cours) ou Complete Order Status (par défaut Terminée) : le paiement a été confirmé. La commande reçoit le Complete Order Status lorsque Auto-complete orders est activé. Une note affiche l'environnement et l'identifiant du paiement dLocal.

On Hold (Review) Status (par défaut En attente) : dLocal Go 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 dans le tableau de bord dLocal Go, puis expédiez la commande ou remboursez le paiement.

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

Un paiement refusé, expiré ou annulé ne modifie jamais une commande qui a déjà un statut. Si un second paiement arrive pour une commande déjà payée, la commande n'est pas modifiée. Une note vous invite à rembourser le paiement en double dans le tableau de bord dLocal Go. Le même type de note est ajouté à la commande payée lorsque le même panier (même session client et même contenu) a été payé une nouvelle fois avec une autre commande, par exemple dans un second onglet du navigateur ; cette autre commande ne conserve aucun statut.

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

Onglet VibeFox dLocal Payment

Dans Sales > Orders, ouvrez une commande payée avec dLocal Go. En bas de la page de la commande, à côté de History et de Additional, l'onglet VibeFox dLocal Payment affiche l'Payment ID, l'Environment (sandbox ou production), le Status du paiement, les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les dLocal Go notes de la commande. L'onglet est affiché aux utilisateurs ayant accès à l'extension.

Remboursements

Dans l'onglet VibeFox dLocal Payment, saisissez le Amount (le montant non encore remboursé est pré-rempli), facultativement une Reason (optional), puis cliquez sur Refund via dLocal Go. Confirmez la question Refund this amount through dLocal Go? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Les remboursements se font dans le montant et la devise débités par dLocal Go ; après un écart de montant ou de devise, vous pouvez donc rembourser jusqu'au montant réellement payé par le client, et non au total de la commande. Le remboursement est envoyé à l'environnement dans lequel le paiement a été effectué, avec les identifiants de cet environnement. Si dLocal Go n'accepte pas le remboursement, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement accepté est ajouté à l'historique des remboursements et aux notes, avec l'identifiant, le statut et la raison du remboursement. Un remboursement total place la commande en Refunded Status sans notifier le client et sans remettre les produits en stock, comme pour un changement de statut manuel. Un remboursement partiel ne modifie pas le statut. Les remboursements sont disponibles une fois que dLocal Go a confirmé le paiement.

dLocal Go communique ensuite le statut final du remboursement par la notification de remboursement, qui est ajouté aux notes. Si dLocal Go rejette ou annule plus tard un remboursement qu'il avait accepté, la note avertit que l'argent n'a pas été restitué au client. Remboursez à nouveau le client ou autrement.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via dLocal Go. Les remboursements effectués dans le tableau de bord dLocal Go ne sont pas enregistrés comme remboursements dans OpenCart. 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 dLocal Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox dLocal Payment > 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) et 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-dlocal et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify sur 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 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 son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, dLocal Go 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 moyen 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 moyen 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é à 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 la licence.

Dépannage

dLocal Go n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que la clé API et le secret API de l'Environment sélectionné sont renseignés. La page des réglages affiche un avertissement s'ils manquent. Vérifiez également 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 réglages.

Le paiement a abouti, mais la commande reste sans statut : dLocal Go n'a pas pu atteindre l'URL de notification (pare-feu, authentification de base ou absence d'adresse HTTPS publique) et le client n'est pas revenu dans la boutique. Activez le Debug log, consultez le champ Log et vérifiez le paiement dans le tableau de bord dLocal Go. Dès qu'une notification arrive ou que le client clique sur Check again, la commande reçoit son statut.

La notification répond Missing signature ou Invalid signature : la clé API et le secret des réglages n'appartiennent pas au compte qui a envoyé la notification. Les notifications sont vérifiées avec les identifiants de l'environnement du paiement ; les paiements lancés avant le changement de Environment sont donc toujours confirmés, tant que les identifiants de leur environnement restent dans les réglages.

La notification répond Gateway not configured : les identifiants de l'environnement du paiement sont absents. Saisissez-les ; dLocal Go renvoie la notification.

La notification répond API verification failed : l'API dLocal Go n'a pas pu être jointe pour lire le paiement. dLocal Go renvoie la notification.

La notification répond Temporarily unavailable : 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. dLocal Go renvoie la notification. La raison figure dans le journal.

La notification répond Order not found : le paiement n'appartient à aucune commande de cette boutique, par exemple parce qu'il a été créé par un autre site avec le même compte dLocal Go.

Le client voit This payment method is temporarily unavailable : dLocal Go a rejeté la clé API ou le secret API. Vérifiez les identifiants de l'environnement sélectionné.

Le client voit Payment gateway is not properly configured : les identifiants de l'environnement sélectionné sont absents.

La commande est au statut de vérification après le paiement : lisez les notes de l'onglet VibeFox dLocal Payment. Le montant ou la devise payés ne correspondaient pas à la commande, ou le paiement est arrivé après l'annulation de la commande. Expédiez la commande ou remboursez le paiement.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : le paiement n'est pas encore confirmé, 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 absents.

Le remboursement échoue avec un message sur des identifiants manquants : le paiement a été effectué dans l'autre environnement, dont les identifiants ne sont pas renseignés. Saisissez-les et réessayez.

Pour les développeurs : l'extension déclenche les événements OpenCart dlocal_p_payment_data (la requête de paiement et la commande, avant la création du paiement) et dlocal_p_currency_decimals (les décimales d'une devise).

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox dLocal Payment. 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 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 dLocal Go en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, environnement, identifiants, pays par défaut, finalisation automatique, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les paiements et remboursements dLocal des commandes 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.

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 dLocal Payment dans la liste des extensions installées, puis sur Delete (le bouton rouge corbeille) pour supprimer le paquet téléchargé.

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