VibeFox Przelewy24 for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Devise : la commande doit être en PLN, EUR, GBP ou CZK. Dans les autres devises, le mode de paiement n'apparaît pas au moment du paiement. La commande est débitée dans sa propre devise ; l'extension ne convertit pas les devises.

Compte Przelewy24 : vous avez besoin d'un compte marchand Przelewy24 et de ses données d'API : le Merchant ID, la clé d'API (appelée report key dans le panneau Przelewy24), la CRC key et, si votre boutique possède son propre identifiant, le POS ID (Shop ID). Vous les trouvez dans le panneau marchand de Przelewy24, à l'adresse panel.przelewy24.pl, sous My data > API data and configuration. Les clés sandbox proviennent d'un compte sandbox distinct, à l'adresse sandbox.przelewy24.pl/panel. Aucune autre configuration n'est nécessaire dans le panneau Przelewy24 : l'extension envoie son URL de notification avec chaque paiement. Votre boutique doit être accessible depuis Internet, car Przelewy24 lui envoie les notifications de paiement.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur 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_przelewy24_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_przelewy24_payment.ocmod.zip. Installez uniquement 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_przelewy24_payment-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD, la section Extensions > Modifications n'a donc pas besoin d'être actualisée. 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 Przelewy24 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 les clés sandbox (Merchant ID, clé d'API, CRC key ; le POS ID uniquement s'il diffère du Merchant ID), activez Enable/Disable, cliquez sur Save et effectuez un paiement test en mode sandbox.

5. Saisissez les clés de production, désactivez Test Mode et cliquez sur Save pour accepter les paiements réels.

OpenCart 4

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

4. Saisissez la clé de licence et les clés Przelewy24 comme aux étapes 3 à 5 pour OpenCart 3. La page des réglages et ses champs sont identiques dans les deux versions. Seule l'URL de notification est différente (voir Notifications de paiement).

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

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre toute la page. Au-dessus des réglages, la page affiche des avertissements lorsqu'un élément manque. Tant que le sandbox est activé : Sandbox (test) mode is on: payments go to the Przelewy24 sandbox and no real money is charged. Do not ship orders paid in test mode. Lorsque les clés du mode actuel sont incomplètes : Enter the Sandbox Merchant ID, API key and CRC key - until then Przelewy24 is not shown at checkout. (ou le même message pour les clés de production). Si Przelewy24 n'accepte pas la devise par défaut de votre boutique, l'avertissement indique la devise en cause et les devises prises en charge. Après l'enregistrement, les avertissements suivent immédiatement le nouveau mode et les nouvelles clés. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, rien n'est enregistré si un champ est incorrect : Title ne doit pas être vide (Enter a title for the payment method (at most 128 characters).), Sort Order doit être un nombre entier (les valeurs négatives sont autorisées), Total doit être un nombre égal ou supérieur à 0, et Geo Zone ainsi que les statuts de commande doivent exister. Les clés manquantes n'empêchent pas l'enregistrement. Les espaces et les sauts de ligne copiés avec les clés depuis le panneau Przelewy24 sont supprimés à l'enregistrement.

Przelewy24

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

Title: le nom du mode de paiement que voient les clients au moment du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Przelewy24. Obligatoire, 128 caractères au maximum.

Description: le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay with BLIK, online bank transfer or card via Przelewy24.

Sort Order: la position de Przelewy24 parmi les modes de paiement au moment du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone: proposer Przelewy24 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, qu'une commande doit atteindre pour que Przelewy24 soit proposé. Laissez le champ vide pour proposer Przelewy24 quel que soit le montant.

Identifiants API

Cette section indique où trouver les clés (My data > API data and configuration dans le panneau marchand de Przelewy24) et contient des liens vers le panneau Przelewy24 et le panneau sandbox.

Test Mode: utilise le sandbox de Przelewy24 et les clés Sandbox. Aucun argent réel n'est débité. Désactivez-le pour accepter de vrais paiements avec les clés de production. Par défaut : on. Tant qu'il est activé, les clients voient Sandbox mode - no real money is charged à l'étape Confirm Order.

Clés de production

Live Merchant ID: votre identifiant marchand Przelewy24, chiffres uniquement.

Live POS ID (optional): le Shop ID (posId). Laissez le champ vide s'il est identique au Merchant ID.

Live API key (report key): la clé d'API du panneau Przelewy24. Elle sert à l'authentification API.

Live CRC key: sert à signer les requêtes envoyées à Przelewy24 et à vérifier la signature des notifications de Przelewy24.

Clés sandbox

Sandbox Merchant ID: le Merchant ID de votre compte sandbox Przelewy24.

Sandbox POS ID (optional): le Shop ID (posId) du compte sandbox. Laissez le champ vide s'il est identique au Merchant ID.

Sandbox API key (report key): la clé d'API du compte sandbox.

Sandbox CRC key: la CRC key du compte sandbox, utilisée pour signer les requêtes et vérifier les notifications sandbox.

Les clés d'API et les CRC keys enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved - leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier. Pour supprimer une clé enregistrée, cochez Clear the saved value sous le champ et cliquez sur Save.

Les clés de production et les clés sandbox sont différentes. Le Merchant ID et le POS ID ne doivent contenir que des chiffres ; tant que le Merchant ID, la clé d'API et la CRC key du mode actuel ne sont pas saisis, le mode de paiement n'est pas affiché au moment du paiement. Un paiement démarré dans un mode est toujours vérifié et remboursé avec les clés de ce mode, même après un changement de mode. Conservez donc les clés de l'ancien mode tant que ses paiements sont en cours ou peuvent être remboursés.

Notifications de paiement

Notification URL: l'adresse qui reçoit les notifications de paiement de Przelewy24. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_przelewy24_payment/notify, sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_przelewy24_payment/payment/wcp_przelewy_24payment.notify. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'extension envoie cette URL à Przelewy24 avec chaque paiement et chaque remboursement ; rien n'est donc à configurer dans le panneau Przelewy24. L'URL doit être accessible depuis Internet : aucun pare-feu ni authentification HTTP ne doit la protéger. Elle reste opérationnelle lorsque la boutique est en mode maintenance, car OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute une action de démarrage pour l'URL de notification et le retour du client. Sans notifications, un paiement est tout de même confirmé lorsque le client revient dans la boutique (voir Paiement) ; si le client ne revient pas, la commande reste sans statut.

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 Przelewy24 a confirmé le paiement et que l'extension l'a vérifié. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Paid Order Status: le statut après un paiement vérifié. Par défaut : Processing.

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

Cancelled Order Status: l'extension ne l'applique jamais. Un paiement vérifié pour une commande dans ce statut place la commande en attente au lieu de la rouvrir silencieusement. Par défaut : Canceled.

Refunded Status: appliqué après le remboursement intégral du paiement depuis la page de la commande. Par défaut : Refunded.

Avancé

Debug Log: écrit les événements techniques (numéros de commande, identifiants de transaction P24, erreurs) dans wc_p24_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 wc_p24_debug.old.log.php. Les erreurs et les avertissements, comme les notifications rejetées ou une vérification ou un remboursement échoué, sont toujours journalisés ; activez l'interrupteur pour journaliser aussi chaque étape. Les clés et les données personnelles ne sont jamais journalisées. 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: lorsqu'il est activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les commandes et leurs données de paiement Przelewy24 ne sont jamais supprimées. Par défaut : off.

Import / Export

Export: Download JSON enregistre les réglages dans un fichier JSON. Les clés d'API et les CRC keys ne sont pas exportées.

Import: collez un JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les clés d'API et CRC keys enregistrées sont conservées.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Przelewy24). À l'étape Confirm Order, le client voit votre description et la note You will be redirected to the secure Przelewy24 page to complete the payment. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension enregistre une transaction Przelewy24 pour le total de la commande dans la devise de la commande, avec l'adresse e-mail, le nom et le pays de facturation du client, ainsi que la description Order # suivie du numéro de commande et du nom de votre boutique. Chaque tentative de paiement reçoit son propre identifiant de session. Le client est envoyé sur la page de paiement de Przelewy24 et paie avec BLIK, un virement bancaire en ligne, une carte ou une autre méthode activée pour votre compte Przelewy24. La page de paiement s'affiche dans la langue de la commande si Przelewy24 la prend en charge, sinon en anglais. 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 paiement.

La commande n'est marquée payée qu'après confirmation de Przelewy24. Przelewy24 envoie à votre boutique une notification signée. L'extension vérifie la signature avec la CRC key, le Merchant ID et le POS ID ; que la session a bien été enregistrée pour cette commande et dans le même mode ; et que le montant et la devise correspondent à la tentative de paiement et au total de la commande. Ce n'est qu'alors qu'elle vérifie la transaction auprès de Przelewy24 (Przelewy24 ne crédite que les paiements vérifiés) et applique Paid Order Status de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour du stock. Les notifications sans signature valide sont rejetées.

Après le paiement, le client revient dans votre boutique. Si la notification n'est pas encore arrivée, l'extension demande à Przelewy24 le statut de la transaction au moyen d'une requête authentifiée de serveur à serveur (au plus une fois toutes les 10 secondes par tentative) et applique les mêmes contrôles. La seule page de retour ne marque jamais une commande comme payée. Une fois le paiement confirmé, le client voit la page de succès de la commande OpenCart. Tant que le paiement n'est pas confirmé, une page Payment confirmation affiche We have not received the payment confirmation from Przelewy24 yet. If you have paid, it will be confirmed in a few minutes. If the payment was interrupted, you can try again: avec un bouton Check again et un bouton Pay again qui ouvre le paiement. Le panier est conservé, et un paiement effectué plus tard depuis une ancienne page Przelewy24 est toujours accepté. Si la commande est en attente, la page de succès affiche Your payment is being verified. We will send you an e-mail as soon as it is confirmed. Lorsqu'un paiement ultérieur fait passer la commande du statut d'attente à Paid Order Status, le client en est informé par e-mail. Si vous avez annulé la commande avant son paiement et que Przelewy24 n'a reçu aucun paiement pour elle, le client qui revient voit Order #… was cancelled by the store before the payment was completed. No Przelewy24 payment was received for it. Please place a new order or contact us.

Si le paiement ne peut pas être lancé, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton : Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (la raison est enregistrée dans le journal), Payment gateway is not configured properly. Please contact the administrator. (clés du mode actuel manquantes), un message indiquant que Przelewy24 ne peut pas accepter de paiements dans la devise de la commande, ou The order total must be greater than zero. OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order s'affiche ; une commande ou un panier déjà payé n'est pas renvoyé à Przelewy24, et le client est dirigé vers la page de succès.

OpenCart 4 conserve une commande pour la caisse et la met à jour chaque fois que l'étape Confirm Order s'affiche ; Pay again lance donc une nouvelle transaction Przelewy24 pour la même commande. Si la boutique a fermé cette commande entre-temps (par exemple annulée ou remboursée), le client est renvoyé à la caisse avec le message Votre commande précédente a été fermée par la boutique. Veuillez confirmer à nouveau la commande pour passer et payer une nouvelle commande. (pour une commande annulée avant tout paiement, avec le message sur la commande annulée ci-dessus), et le prochain Confirm Order paie une nouvelle commande. Si la commande de la caisse est déjà payée mais que le panier a changé depuis, y compris une nouvelle quantité, le client voit Votre commande précédente n° … a déjà été passée. Votre panier a changé : veuillez confirmer la nouvelle commande pour la payer., et le nouveau panier est payé par une nouvelle commande. Sur OpenCart 4, ces messages ainsi que Nous n'avons pas pu associer ce paiement à une commande. Si vous avez été débité, veuillez nous contacter. s'affichent au-dessus de la page de paiement.

L'extension ne propose ni cartes enregistrées ni paiement en un clic, ni abonnements ou paiements récurrents, ni choix de la méthode de paiement P24 (par exemple un champ pour le code BLIK) sur votre page de paiement, ni offres de paiement en plusieurs fois, et n'envoie pas le contenu du panier à Przelewy24.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé sur Przelewy24 et n'a pas payé, ou le paiement n'est pas encore confirmé. 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 Processing) : le paiement a été vérifié. Une note indique l'identifiant de commande P24, le montant et le mode. Chaque paiement n'est appliqué qu'une seule fois.

On Hold (Review) Status (par défaut Pending) : le montant ou la devise transmis par Przelewy24 diffère de la commande ; le paiement n'a pas été confirmé et la note le précise. Ou bien le paiement est arrivé et a été vérifié pour une commande au statut annulé ; la commande n'est pas rouverte silencieusement, la note vous demande de l'expédier ou de rembourser le paiement. Vérifiez le paiement dans le panneau Przelewy24. Si, après un écart, un paiement correct d'une autre tentative arrive plus tard pour une commande en attente, la commande passe à Paid Order Status.

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

Si un second paiement arrive pour une commande ou un panier déjà payé ou remboursé (ancien lien de paiement, deux onglets du navigateur, autre commande du même panier), il n'est pas confirmé et Przelewy24 ne le crédite pas. Une note sur la commande payée vous demande de le vérifier dans le panneau Przelewy24 et de le rembourser à l'acheteur si nécessaire.

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

Onglet VibeFox Przelewy24 Payment

Dans Sales > Orders, ouvrez une commande payée avec Przelewy24. En bas de la page de commande, à côté de History et Additional, l'onglet VibeFox Przelewy24 Payment affiche l'identifiant de commande P24, la Session, l'Environment (Sandbox ou Live), le Status du paiement et son mode de vérification (notification ou retour), les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les Payment notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox Przelewy24 Payment, saisissez le Amount (le montant non encore remboursé est prérempli), facultativement un Reason (optional), puis cliquez sur Refund via Przelewy24. Confirmez la question Refund this amount through Przelewy24? This cannot be undone. Les remboursements totaux et partiels sont pris en charge, dans la limite du montant non encore remboursé. Vous devez avoir le droit de modifier l'extension (à régler dans System > Users > User Groups). Le remboursement est envoyé dans le mode dans lequel le paiement a été effectué (sandbox ou production), les clés de ce mode doivent donc être renseignées. Les remboursements sont disponibles une fois que Przelewy24 a vérifié le paiement.

Przelewy24 traite les remboursements de manière asynchrone. L'onglet affiche Refund of … requested at Przelewy24. The result will be added as an order note., l'historique des remboursements affiche le statut requested, et une note est ajoutée. Le résultat arrive plus tard à l'URL de notification : le statut devient completed avec la note Przelewy24: refund of … completed., ou rejected avec une note indiquant que l'argent n'a pas été restitué à l'acheteur. Un remboursement total place la commande en Refunded Status au moment de la demande, sans notifier le client et sans remettre les produits en stock, comme une modification manuelle du statut. Un remboursement partiel ne modifie pas le statut. Si un remboursement est rejeté, vérifiez-le dans le panneau Przelewy24 ; le statut de la commande n'est pas rétabli automatiquement.

Si Przelewy24 n'accepte pas la demande de remboursement, l'onglet affiche Przelewy24 refund failed: avec la raison, et aucun remboursement n'est enregistré. Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Przelewy24, et les remboursements effectués directement dans le panneau Przelewy24 ne sont pas ajoutés à la commande.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Przelewy24 Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox Przelewy24 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) 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-przelewy24 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, Przelewy24 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 de pouvoir 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 continuent d'être vérifiés et 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é à 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 son statut.

Dépannage

Przelewy24 n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le Merchant ID, la clé d'API et la CRC key du mode actuel sont saisis (les clés Sandbox tant que Test Mode est activé, les clés de production sinon ; Merchant ID et POS ID en chiffres uniquement) et que la devise de la commande est PLN, EUR, GBP ou CZK. Les avertissements en haut des réglages indiquent le problème. Vérifiez également que l'adresse de facturation fait partie de la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages.

Le paiement a été effectué, mais la commande reste sans statut : la notification de Przelewy24 n'est pas parvenue à votre boutique et le client n'y est pas revenu. Vérifiez que la Notification URL est accessible depuis Internet (aucun pare-feu ni authentification HTTP devant elle) et que le Merchant ID, le POS ID et la CRC key du mode du paiement sont corrects. Les notifications rejetées sont inscrites dans le journal même lorsque Debug Log est désactivé ; consultez le champ Log sur la page de l'extension.

Comment la boutique répond aux notifications : une notification traitée, répétée ou inconnue reçoit une réponse HTTP 200. Sinon, Przelewy24 la renvoie plus tard : 400 (données absentes ou mal formées), 401 Invalid signature (mauvaise CRC key, autre Merchant ID ou POS ID), 401 Invalid signature for this payment (notification signée avec les clés de l'autre mode que celui du paiement), 405 (requête autre qu'un POST), 500 Verification failed (la vérification auprès de Przelewy24 a échoué ; une note est ajoutée à la commande une seule fois), 500 Order could not be updated (le statut de la commande n'a pas pu être appliqué ; la notification suivante l'applique sans nouvelle vérification) et 503 Busy, retry later (la commande était en cours de confirmation par une autre requête au même moment).

Le client voit Payment error: Przelewy24 could not start the payment : Przelewy24 a rejeté la transaction, généralement à cause de clés incorrectes du mode actuel (les clés sandbox ne fonctionnent qu'en mode sandbox, les clés de production uniquement en mode production). L'erreur renvoyée par Przelewy24 figure dans le journal.

Le client voit We could not match this payment to an order : le lien de retour de Przelewy24 ne correspond à aucune commande de la boutique. Si le client a été débité, retrouvez le paiement dans le panneau Przelewy24.

La commande est en statut de vérification après le paiement : lisez les notes de l'onglet VibeFox Przelewy24 Payment. Le montant ou la devise différait de la commande, ou le paiement est arrivé pour une commande qui avait été annulée. Vérifiez le paiement dans le panneau Przelewy24, puis traitez la commande ou remboursez le paiement.

Un remboursement échoue : This order has no verified Przelewy24 payment. Cannot process refund. signifie que la commande n'a pas été payée par un paiement Przelewy24 vérifié. The payment was made in the Przelewy24 sandbox, but the Sandbox keys are missing. (ou le même message pour la production) signifie que les clés du mode du paiement ont été supprimées ; saisissez-les de nouveau. Invalid refund amount signifie que le montant est vide, n'est pas un nombre, ou dépasse le montant non encore remboursé.

Pour les développeurs : la liste des devises peut être modifiée avec l'événement OpenCart wc_p24_supported_currencies (uniquement les devises à deux décimales).

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Przelewy24 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 les notifications et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, clés, interrupteur du journal de débogage) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les données de paiement Przelewy24 des commandes (sessions, identifiants de commande P24, remboursements) sont toujours conservées, 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 Przelewy24 Payment dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet téléversé.

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