VibeFox MercadoPago for OpenCart — Hilfe

Voraussetzungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Shop-Währung: Die Währung des Landes Ihres MercadoPago-Kontos muss im Shop aktiviert sein: ARS (Argentinien), BRL (Brasilien), CLP (Chile), COP (Kolumbien), MXN (Mexiko), PEN (Peru) oder UYU (Uruguay). MercadoPago belastet in der Kontowährung und rechnet nicht um. Die Zahlungsart wird daher nur Kunden angezeigt, die in dieser Währung bezahlen.

MercadoPago-Konto: Sie benötigen eine Anwendung im MercadoPago-Entwicklerbereich (Your integrations > your application > Credentials) mit den Testzugangsdaten (beginnen mit TEST-) und den Produktivzugangsdaten (beginnen mit APP_USR-): jeweils einen Public Key und einen Access Token. Für die optionale Prüfung der Benachrichtigungssignatur benötigen Sie außerdem das geheime Signaturpasswort aus your application > Webhooks.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_mercadopago_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_mercadopago_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_mercadopago_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox MercadoPago Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Wählen Sie das Account country, geben Sie die Test- und Produktivzugangsdaten ein und richten Sie optional Benachrichtigungen in Ihrer MercadoPago-Anwendung ein (siehe Konfiguration). Prüfen Sie, ob die Währung des Kontos unter System > Localisation > Currencies aktiviert ist.

5. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Testmodus mit den MercadoPago-Testkarten und deaktivieren Sie danach Test mode.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_mercadopago_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox MercadoPago Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Zugangsdaten und die Benachrichtigungen ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Zahlungsbenachrichtigungen (Webhooks)).

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Test mode is on: the TEST- credentials are used and no real money is charged. an, solange der Testmodus aktiv ist. Sie wird gewarnt, wenn der Public Key oder der Access Token des aktuellen Modus fehlt (die Zahlungsart wird dann in der Kasse ausgeblendet), wenn die Standardwährung des Shops nicht der Währung Ihres MercadoPago-Kontos entspricht (die Zahlungsart wird dann nur Kunden angezeigt, die in der Kontowährung bezahlen, oder ausgeblendet, wenn der Shop diese Währung nicht aktiviert hat) und wenn die Zugangsdaten zu einem Konto in einem anderen Land gehören als dem unter Account country angegebenen. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Wenn Sie mit einem leeren Title (oder einem mit mehr als 128 Zeichen) speichern, wird nichts gespeichert, und die Seite zeigt Enter a title for the payment method (1 to 128 characters). an. Jeder andere falsche Wert wird nicht gespeichert und behält seinen bisherigen Wert, mit einer Fehlermeldung, die das Feld nennt und mit — the previous value was kept. endet. Das betrifft Zugangsdaten, die nicht mit dem erwarteten Präfix beginnen (TEST- für Testfelder, APP_USR- für Produktivfelder), Maximum installments außerhalb von 1–24, eine Sort Order, die keine ganze Zahl ist (Sort Order must be a whole number), einen Total, der keine Zahl größer oder gleich 0 ist, sowie eine Geozone oder einen Bestellstatus, der nicht existiert. Nach dem Speichern fragt die Erweiterung bei MercadoPago ab, zu welchem Land jeder Access Token gehört. Kann der Token des aktuellen Modus nicht geprüft werden, liegt das Konto nicht in einem unterstützten Land oder weicht das Land von Account country ab, wird eine Warnung angezeigt. Die Erweiterung verwendet dann das Land des Kontos.

MercadoPago

Enable / Disable: Enable MercadoPago card payments schaltet die Zahlungsart ein oder aus. Die Zahlungsart wird in der Kasse nur angezeigt, wenn die Zugangsdaten des aktiven Modus ausgefüllt sind und der Kunde in der Währung des MercadoPago-Kontos bezahlt. Standard: aus.

Title: der Name der Zahlungsart, der dem Kunden in der Kasse angezeigt wird. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Credit or debit card (MercadoPago). Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der im Schritt Confirm Order oberhalb der Kartenfelder angezeigt wird. Standard: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

Sort Order: die Position von MercadoPago unter den Zahlungsarten in der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: bietet MercadoPago nur für Zahlungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor MercadoPago angeboten wird. Lassen Sie das Feld leer, um MercadoPago bei jedem Betrag anzubieten.

MercadoPago-Konto

Holen Sie die Zugangsdaten Ihrer Anwendung im MercadoPago-Entwicklerbereich: Your integrations > your application > Credentials (die Seite verlinkt dorthin). Testzugangsdaten beginnen mit TEST-, Produktivzugangsdaten mit APP_USR-.

Account country: das Land Ihres MercadoPago-Kontos. Es bestimmt die Abrechnungswährung, die Sprache der Kartenfelder und ob das Ausweisdokument des Karteninhabers abgefragt wird. Der Kunde muss in derselben Währung bezahlen, zum Beispiel ARS für Argentinien. Beim Speichern der Zugangsdaten wird das Land mit dem Konto abgeglichen. Standard: Argentina (ARS).

Test mode: Im Testmodus werden die TEST-Zugangsdaten verwendet und Sie bezahlen mit MercadoPago-Testkarten; in der Kasse wird ein Hinweis TEST MODE mit Use MercadoPago test cards. No real charges. angezeigt. Schalten Sie ihn aus, um echte Karten mit den Produktivzugangsdaten zu belasten. Erstattungen und Benachrichtigungen verwenden immer die Zugangsdaten des Modus, in dem die Zahlung erfolgte. Standard: ein.

Test Public Key: beginnt mit TEST-. Wird im Browser zur Tokenisierung der Karte verwendet.

Test Access Token: beginnt mit TEST-. Wird nur auf dem Server verwendet. Halten Sie ihn geheim.

Production Public Key: beginnt mit APP_USR-.

Production Access Token: beginnt mit APP_USR-. Wird nur auf dem Server verwendet. Halten Sie ihn geheim.

Gespeicherte Access Tokens und das Webhook-Geheimnis werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Zahlungsoptionen

Maximum installments: die höchste Anzahl an Teilzahlungen (cuotas oder parcelas), die der Kunde wählen kann, von 1 bis 24. 1 = nur Einmalzahlung. Das Limit wird auch auf dem Server durchgesetzt. Standard: 1.

Zahlungsbenachrichtigungen (Webhooks)

Kartenzahlungen erhalten meist sofort eine endgültige Antwort. Zahlungen, die MercadoPago zur Prüfung zurückhält (in Bearbeitung oder ausstehend), werden durch Benachrichtigungen von MercadoPago abgeschlossen. Die Erweiterung sendet die Benachrichtigungs-URL bei jeder Zahlung, wenn Ihr Shop eine öffentliche Adresse hat (nicht localhost und keine Domain auf .local oder .test). Sie können sie auch unter your application > Webhooks beim Ereignis Payments hinzufügen. Die URL wird in diesem Abschnitt unter Notification URL angezeigt. Auf OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

Einer Benachrichtigung wird nie einfach vertraut. Die Erweiterung ruft die Zahlung über die MercadoPago-API erneut ab, und zwar mit dem Access Token der Umgebung, in der die Zahlung erfolgte, und ordnet sie einem Zahlungsversuch Ihres Shops zu. Ohne Benachrichtigungen bleiben Bestellungen in Prüfung unter Awaiting MercadoPago Status, bis Sie sie manuell aktualisieren.

Die Erweiterung verarbeitet folgende MercadoPago-Zahlungsstatus:

Webhook secret signature: optional. Das geheime Signaturpasswort aus your application > Webhooks. Ist es gesetzt, werden Benachrichtigungen ohne gültige x-signature abgelehnt (HTTP 401).

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine unvollständige Bestellung). Sie erhält erst dann einen Status, nachdem MercadoPago geantwortet hat. Wird eine Karte abgelehnt, bleibt die Bestellung ohne Status (eine Notiz erklärt den Grund), und der Kunde bleibt im Schritt Confirm Order. Jedes der folgenden Felder zeigt Ihre OpenCart-Bestellstatus.

Order Status After Payment: MercadoPago hat die Zahlung genehmigt, und Betrag und Währung stimmen mit der Bestellung überein. Standard: In Bearbeitung.

Awaiting MercadoPago Status: die Zahlung wird bei MercadoPago geprüft (in Bearbeitung oder ausstehend); die Benachrichtigung schließt die Bestellung ab. Standard: Ausstehend.

On Hold (Review) Status: MercadoPago hat einen anderen Betrag oder eine andere Währung als die Bestellung genehmigt oder einen unerwarteten Status zurückgegeben. Eine Notiz erklärt, was im MercadoPago-Panel zu prüfen ist. Standard: Ausstehend, da OpenCart keinen Status „On hold“ hat. Sie können eigene Status unter System > Localisation > Order Statuses anlegen, um wartende und zu prüfende Bestellungen zu unterscheiden.

Payment Failed Status: eine Zahlung, die geprüft wurde, wurde von MercadoPago abgelehnt oder storniert. Standard: Fehlgeschlagen.

Cancelled Status: eine Bestellung in diesem Status (oder im Status „erstattet“) ist abgeschlossen: Eine späte Genehmigung durch MercadoPago fügt nur eine Notiz hinzu. Standard: Storniert.

Refunded Status: die Zahlung wird über die Bestellseite vollständig erstattet. Teilerstattungen fügen nur eine Notiz hinzu. Standard: Erstattet.

Erweitert

Debug log: schreibt MercadoPago-Anfragen und Benachrichtigungen in wc_mpg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert, auch wenn diese Einstellung aus ist. Zugriffstoken, Kartentoken und Zahlerdaten werden nicht protokolliert. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete data on uninstall: ist dies aktiviert, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll. MercadoPago-Zahlungsdatensätze und Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Zugriffstoken und das Webhook-Geheimnis werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Geheimnisse bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit or debit card (MercadoPago)). OpenCart erstellt die Bestellung im Schritt Confirm Order, weiterhin ohne Status. Dort sieht der Kunde Ihre Beschreibung und füllt die Kartenfelder aus: Card number, Expiry (MM/YY), Security code und Cardholder name. Je nach Land und Karte wählt der Kunde außerdem Document type und gibt Document number ein, wählt den Card issuer und die Anzahl der Installments. Die Teilzahlungsoptionen und Zinsen stammen von MercadoPago für den Bestellbetrag.

Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options. Die Kartenfelder erscheinen dann im Bestätigungsblock unten auf der Kasse, über der Schaltfläche Confirm Order.

Wenn der Kunde auf Confirm Order klickt, wandelt MercadoPago die Karte in ein einmalig gültiges Token um, und Ihr Shop erstellt die Zahlung auf dem Server für den Bestellbetrag in der Bestellwährung. E-Mail-Adresse und Name des Kunden sowie das Dokument werden an MercadoPago übergeben; die Zahlung erscheint als Order #, mit der Bestellnummer und dem Namen Ihres Shops. Beträge in CLP und COP werden ohne Dezimalstellen belastet.

Eine genehmigte Zahlung setzt den Bestellstatus auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung; der Warenkorb wird geleert, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Eine Zahlung in Prüfung setzt Awaiting MercadoPago Status, und die Seite zeigt außerdem MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. Eine Bestellung im Prüfstatus zeigt Your payment is being reviewed. We will update your order as soon as the review is complete.

Eine abgelehnte Karte lässt die Bestellung ohne Status. Der Kunde bleibt im Schritt Confirm Order mit einem kurzen Grund, zum Beispiel Your card has insufficient funds. Please use another card or payment method. oder Please check the security code of your card. Der Kunde kann die Daten korrigieren oder eine andere Karte verwenden; für jeden Versuch wird ein neues Kartentoken erstellt. Fehlen Kartendaten, erscheint Please fill in all card fields.

Antwortet MercadoPago nicht, sieht der Kunde We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. Der nächste Versuch prüft zuerst die Zahlung, damit die Karte nicht doppelt belastet wird. Ein zweiter Klick, während der Warenkorb bezahlt wird, zeigt This order is already being paid. Please wait a moment and check your e-mail before trying again. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 behält eine Bestellung für die Kasse, und nach einer abgelehnten Karte bezahlt der Kunde dieselbe Bestellung. In beiden Fällen wird ein Warenkorb mit einer bezahlten oder wartenden Bestellung nie erneut belastet; der Kunde wird zur Erfolgsseite weitergeleitet.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert), wird sie nicht belastet, und der Kunde sieht Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. Ist die Bestellung bereits aufgegeben und der Warenkorb hat sich seitdem geändert, lautet die Meldung Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

Die Benachrichtigungs-URL funktioniert auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startup-Aktion dafür hinzu.

Die Erweiterung akzeptiert nur Kredit- und Debitkarten. Sie bietet keine Weiterleitung zu Checkout Pro, keine MercadoPago-Wallet oder Kontoguthaben, keine Barzahlung (Rapipago, OXXO, Boleto und andere), kein Pix, PSE oder Yape, keine gespeicherten Karten oder Abonnements, keine getrennte Autorisierung und Erfassung, keine 3-D-Secure-Abfrage und keine Währungsumrechnung.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): die Karte wurde abgelehnt, oder MercadoPago hat noch nicht geantwortet. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard In Bearbeitung): MercadoPago hat die Zahlung genehmigt, und Betrag und Währung stimmen mit der Bestellung überein. Eine Notiz zeigt die Zahlungs-ID, die Umgebung und die Anzahl der Teilzahlungen.

Awaiting MercadoPago Status (Standard Ausstehend): die Zahlung wird geprüft (in Bearbeitung oder ausstehend) und wartet auf die MercadoPago-Benachrichtigung. Die Bestellung wechselt zu Order Status After Payment, sobald MercadoPago sie genehmigt.

On Hold (Review) Status (Standard Ausstehend): der genehmigte Betrag oder die Währung weicht von der Bestellung ab, oder MercadoPago hat einen unerwarteten Status zurückgegeben. Die Notiz erklärt es. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Payment Failed Status (Standard Fehlgeschlagen): eine geprüfte Zahlung wurde abgelehnt oder storniert. Die Notiz zeigt den Status und seine Details.

Refunded Status (Standard Erstattet): die Zahlung wurde über die Erweiterung vollständig erstattet.

Wird eine Zahlung für eine bereits stornierte oder erstattete Bestellung von MercadoPago genehmigt, ändert sich der Status nicht, und eine Notiz bittet Sie, die Bestellung abzuschließen oder die Zahlung zu erstatten. Trifft für eine Bestellung oder einen Warenkorb, der bereits bezahlt ist, eine weitere Zahlung ein, bittet Sie eine Notiz, die zusätzliche Zahlung im MercadoPago-Panel zu erstatten.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Registerkarte VibeFox MercadoPago Gateway

Öffnen Sie unter Sales > Orders eine mit MercadoPago bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox MercadoPago Gateway die Payment ID, den Zahlungs-Status, die Environment (ein Etikett Test für Testzahlungen), die Installments, die Beträge Charged / order, den erstatteten Betrag Refunded, das Erstattungsformular, den Erstattungsverlauf und die MercadoPago notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox MercadoPago Gateway den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via MercadoPago. Bestätigen Sie die Frage Refund this amount through MercadoPago? This cannot be undone. Voll- und Teilerstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups). Erstattungen sind auf den von MercadoPago belasteten Betrag begrenzt; nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, und nicht den Bestellbetrag. Die Erstattung wird mit den Zugangsdaten der Umgebung gesendet, in der die Zahlung erfolgte (Test oder Produktiv), daher muss der Access Token dieser Umgebung gesetzt sein. Lehnt MercadoPago die Erstattung ab, zeigt die Registerkarte MercadoPago refused the refund mit dem Grund an, und es wird keine Erstattung erfasst. Eine genehmigte oder in Bearbeitung befindliche Erstattung wird mit der Erstattungs-ID dem Erstattungsverlauf und den Notizen hinzugefügt. Eine Vollerstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns zahlen über MercadoPago kein Geld zurück.

Erstattungen, Rückbuchungen und Schlichtungen, die im MercadoPago-Panel vorgenommen werden, kommen über die Benachrichtigung an und werden den Notizen hinzugefügt. Der Bestellstatus wird nicht automatisch geändert. Aktualisieren Sie ihn bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox MercadoPago Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-mercadopago und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird MercadoPago Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 gibt es diese Vorschau nicht: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint im Admin-Dashboard eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Admin-Dashboard oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

MercadoPago erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und der aktuelle Modus beide Zugangsdaten mit dem richtigen Präfix hat: die TEST-Schlüssel im Testmodus, die APP_USR-Schlüssel im Produktivbetrieb. Prüfen Sie, ob der Kunde in der Währung Ihres MercadoPago-Kontos bezahlt (die Währung muss im Shop aktiviert sein), ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht. Die Einstellungsseite zeigt an, was fehlt.

Die Zahlung wurde durchgeführt, aber die Bestellung bleibt unter Awaiting MercadoPago Status: Die Benachrichtigung ist nicht angekommen. Die Erweiterung sendet die Benachrichtigungs-URL nur, wenn Ihr Shop eine öffentliche Adresse hat (nicht localhost und keine Domain auf .local oder .test). Fügen Sie die URL aus Notification URL unter your application > Webhooks mit dem Ereignis Payments hinzu. Ist Webhook secret signature gesetzt, prüfen Sie, ob es das Geheimnis derselben Anwendung ist. Das MercadoPago-Panel zeigt für jede Benachrichtigung die Antwort Ihres Shops.

Die Benachrichtigung meldet invalid signature: Das Signaturpasswort gehört zu einer anderen Anwendung, oder die Benachrichtigung hat keine gültige x-signature. Kopieren Sie das Geheimnis erneut oder lassen Sie das Feld leer.

Die Benachrichtigung meldet no credentials for test oder no credentials for live: der Access Token der Umgebung, in der die Zahlung erfolgte, ist nicht gesetzt. Tragen Sie ihn ein; MercadoPago wiederholt die Benachrichtigung.

Die Benachrichtigung meldet not for this store: Die Zahlung gehört nicht zu einem Zahlungsversuch dieses Shops. Es wird keine Bestellung geändert.

Die Benachrichtigung meldet order busy oder payment could not be read: Die Bestellung wurde gerade von einer anderen Anfrage aktualisiert, oder MercadoPago war nicht erreichbar. MercadoPago wiederholt die Benachrichtigung automatisch.

Eine Zugangsdaten werden nicht gespeichert: Die Fehlermeldung must start with zeigt, dass der Wert das falsche Präfix für das Feld hat. Testfelder akzeptieren TEST-Zugangsdaten, Produktivfelder APP_USR-Zugangsdaten.

Der Kunde sieht „This payment method is not configured correctly. Please choose another payment method or contact the store.“: Die Zugangsdaten des aktuellen Modus fehlen, haben das falsche Präfix oder wurden von MercadoPago abgelehnt. Prüfen Sie sie auf der Einstellungsseite.

Der Kunde sieht „MercadoPago cannot process payments in“: Die Bestellwährung ist nicht die Währung Ihres MercadoPago-Kontos. MercadoPago rechnet Währungen nicht um.

Das sichere Kartenformular lädt nicht: Der Kunde sieht The secure card form could not be loaded. Please reload the page or choose another payment method. Prüfen Sie den Public Key des aktuellen Modus.

Der Kunde sieht „Your session has expired. Please reload the page and try again.“: Das Kartenformular gehört nicht mehr zur Kassensitzung des Kunden. Der Kunde lädt die Kassenseite neu.

Der Kunde sieht „Your payment was received, but the order could not be completed automatically“: MercadoPago hat die Zahlung angenommen, aber OpenCart konnte den Bestellstatus nicht setzen. Sehen Sie im Feld Log auf der Erweiterungsseite nach: Fehler werden immer protokolliert. Der Kunde wird gebeten, nicht erneut zu zahlen; der nächste Zahlungsversuch oder die nächste Benachrichtigung für den Warenkorb setzt den Status ohne neue Belastung.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die MercadoPago notes im Reiter der Bestellung (siehe Bestellstatus) und erfüllen Sie danach die Bestellung oder erstatten Sie die Zahlung.

Die Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung wurde im Test- oder Produktivmodus gemacht, und der Access Token dieses Modus ist nicht gesetzt. Tragen Sie ihn ein und versuchen Sie es erneut.

Die Erstattung schlägt mit MercadoPago did not answer the refund request fehl: Prüfen Sie die Zahlung im MercadoPago-Panel, bevor Sie es erneut versuchen.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox MercadoPago Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable / Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 zusätzlich dessen Startup-Aktion, die Benachrichtigungen im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Account country, Testmodus, Zugangsdaten, Teilzahlungen, Webhook-Geheimnis, Protokollierung), die gespeicherte Kontoprüfung und das Protokoll entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die MercadoPago-Zahlungsdatensätze und Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auf OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie neben VibeFox MercadoPago Gateway in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche). Klicken Sie dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

MercadoPago ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit MercadoPago verbunden und wird von MercadoPago nicht unterstützt.