VibeFox Vindi for OpenCart — Hilfe

Anforderungen

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.

Währung: Brasilianischer Real (BRL) muss unter System > Localisation > Currencies eingerichtet sein. Vindi rechnet nur in BRL ab, daher wird die Zahlungsart nur angezeigt, wenn der Kunde in BRL bezahlt.

Vindi-Konto: Sie benötigen den API-Schlüssel Ihres Vindi-Kontos. Die Vindi-Sandbox ist ein separates Vindi-Testkonto mit eigenem Schlüssel. Boleto, PIX und BolePix müssen außerdem in Ihrem Vindi-Konto aktiviert sein, wenn Sie sie anbieten möchten.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt 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_vindi_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_vindi_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

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

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

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

4. Fügen Sie den Sandbox API key ein und, wenn Sie so weit sind, den Live API key. Wählen Sie die Offered methods aus.

5. Kopieren Sie die Webhook-URL aus den Einstellungen nach Vindi (siehe Konfiguration).

6. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Sandbox-Modus und deaktivieren Sie danach Sandbox mode, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_vindi_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung 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 Vindi 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 API-Schlüssel, die Zahlungsarten und den Webhook ein wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Webhook-URL ist anders (siehe Webhook).

Eine Neuinstallation startet mit deaktivierter Zahlungsart und aktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite den Modus an, TEST MODE oder LIVE, und warnt, wenn der API-Schlüssel des aktuellen Modus leer ist (dann wird die Zahlungsart im Checkout nicht angezeigt) oder wenn die Standardwährung des Shops nicht BRL ist (dann wird die Zahlungsart nur angezeigt, wenn der Kunde in BRL bezahlt). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern werden die Schlüssel so gespeichert, wie sie eingegeben wurden, ohne Leerzeichen am Anfang und Ende. Ist keine Zahlungsart ausgewählt, wird Kreditkarte gespeichert und die Seite zeigt Choose at least one payment method — credit card was selected. Ein leerer Title oder einer mit mehr als 128 Zeichen, eine Sort Order, die keine ganze Zahl ist (negative Werte sind erlaubt), eine Total, die keine Zahl von 0 oder mehr ist, oder eine Geozone bzw. ein Bestellstatus, der nicht existiert, wird nicht akzeptiert: Es wird nichts gespeichert, und die Seite zeigt die Meldung, zum Beispiel Enter a title for the payment method (1 to 128 characters).

Vindi

Enable / Disable: Enable Vindi payments schaltet die Zahlungsart ein oder aus. Standard: ausgeschaltet.

Title: der Name der Zahlungsart, der im Checkout angezeigt wird. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Vindi. Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über den Zahlungsfeldern sieht. Standard: Pay by credit card on the secure Vindi page, or by boleto / PIX.

Sort Order: die Position von Vindi unter den Zahlungsarten im Checkout. Leer lassen oder eine ganze Zahl eingeben (negative Werte sind erlaubt).

Geo Zone: Vindi nur für Zahlungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Total: die Checkout-Summe in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Vindi angeboten wird. Leer lassen, um Vindi für jede Summe anzubieten.

API-Schlüssel

Erstellen Sie die Schlüssel im Vindi-Dashboard unter Settings > API keys: auf app.vindi.com.br für den Live-Betrieb und auf sandbox-app.vindi.com.br für die Sandbox. Live und Sandbox haben getrennte Hosts und Schlüssel. Jede Zahlung merkt sich, wo ihre Rechnung erstellt wurde, sodass Prüfungen, Stornierungen und Erstattungen immer diese Umgebung verwenden.

Sandbox mode: erstellt neue Zahlungen in der Vindi-Sandbox, über sandbox-app.vindi.com.br mit dem Sandbox-API-Schlüssel. Kunden sehen im Checkout einen Hinweis TEST MODE: Vindi sandbox: no real charges. Standard: eingeschaltet. Schalten Sie ihn aus, um echte Zahlungen anzunehmen.

Live API key: der private Schlüssel des Live-Vindi-Kontos. Er wird nur an die Vindi-API gesendet.

Sandbox API key: der private Schlüssel des Vindi-Sandbox-Kontos.

Gespeicherte Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, markieren Sie unter dem Feld Clear the saved key on save und klicken Sie auf Save.

Zahlungsarten

Offered methods: die Zahlungsarten, die Kunden wählen können. Standard: Kreditkarte. Die Zahlungsarten müssen außerdem in Ihrem Vindi-Konto aktiviert sein.

Boleto, PIX und BolePix benötigen die CPF oder CNPJ des Kunden, die im Checkout abgefragt wird.

Zahlungsbenachrichtigungen (Webhook)

Der Webhook teilt Ihrem Shop mit, dass eine Rechnung bezahlt, storniert, abgelehnt oder erstattet wurde. Das Feld Webhook URL dieses Abschnitts zeigt die URL. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=..., auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=.... Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet und enthält ein geheimes Token, das die Erweiterung erzeugt. Kopieren Sie sie genau so, wie die Einstellungen sie anzeigen. Gehen Sie in Vindi zu Settings > Webhooks, sowohl im Live-Konto als auch im Sandbox-Konto, fügen Sie diese URL hinzu und wählen Sie folgende Ereignisse aus:

Vindi signiert seine Benachrichtigungen nicht. Anfragen mit fehlendem oder falschem Token werden daher abgelehnt, und jede Benachrichtigung veranlasst die Erweiterung nur dazu, die Rechnung über die Vindi-API erneut abzurufen, bevor sich eine Bestellung ändert. Die URL funktioniert auch, wenn der Shop im Wartungsmodus ist (unter OpenCart 4 lässt eine Startaktion der Erweiterung den Webhook und die Zahlungsstatusseite durch). Vindi-Rechnungen haben keine Rückkehr-URL. Ohne den Webhook wird eine Kartenzahlung daher nur erkannt, wenn der Kunde die Bestellung mit demselben Warenkorb erneut bestätigt (dann wird die bezahlte Rechnung gefunden), und eine Boleto- oder PIX-Zahlung, wenn der Kunde die Bestellung in seinem Konto erneut öffnet (My Account > Order History).

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine Bestellung ohne Status). Sie erhält einen Status erst, nachdem Vindi die Rechnung gemeldet hat; die Rechnung wird immer von Vindi erneut abgerufen. Bestellungen mit Boleto, PIX und BolePix erhalten den Status „ausstehend“, sobald die Rechnung ausgestellt ist. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf. OpenCart hat keinen Status „zurückgehalten“, daher verwenden die Status „ausstehend“ und „zurückgehalten“ standardmäßig Ausstehend; die Bestellnotizen unterscheiden sie. Eigene Status können Sie unter System > Localisation > Order Statuses anlegen und hier auswählen.

Order Status After Payment: wird nach einer geprüften Vindi-Zahlung gesetzt. Standard: In Bearbeitung.

Awaiting Vindi Payment Status: Boleto, PIX oder BolePix wurde im Checkout ausgestellt; Vindi bestätigt den Geldeingang später. Die Zahlungsdaten werden dem Verlaufskommentar hinzugefügt, den der Kunde sieht. Standard: Ausstehend.

Vindi Payment On Hold Status: die Rechnung wird bei Vindi geprüft, die bezahlte Rechnung passt nicht zur Bestellung (Währung, Betrag, Rechnungscode oder Vindi-Kunde), oder sie wurde bezahlt, nachdem die Bestellung storniert worden war. Eine Notiz erklärt den Grund. Standard: Ausstehend.

Payment Error Status: Vindi hat den Zahlungsversuch einer wartenden Bestellung abgelehnt. Der Kunde kann dieselbe Rechnung noch bezahlen; eine spätere Zahlung setzt den Status nach Zahlung. Standard: Fehlgeschlagen.

Canceled Status: die Rechnung einer wartenden Bestellung wurde bei Vindi storniert. Wenn Sie eine Bestellung dieser Erweiterung auf diesen Status setzen, wird auch ihre offene Vindi-Rechnung storniert. Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung über die Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: protokolliert API-Aufrufe und Benachrichtigungen in wc_vdi_debug.log.php im Logs-Ordner von OpenCart (storage/logs, unter OpenCart 4 system/storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler und Warnungen werden immer protokolliert, auch wenn diese Option aus ist. Schlüssel, das Webhook-Token und Kundendaten werden nie protokolliert. Standard: aus.

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

Delete data on uninstall: Wenn eingeschaltet, entfernt die Deinstallation der Erweiterung die Einstellungen, das Webhook-Token, den Produkt-Cache und das Protokoll. Bestellungen und die Vindi-Rechnungsverweise der Bestellungen bleiben erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die API-Schlüssel werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten API-Schlüssel bleiben erhalten.

Checkout

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Vindi). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. Werden mehrere Zahlungsarten angeboten, zeigt das Zahlungsfeld Pay with und eine Auswahl aus Kreditkarte, Boleto, PIX oder BolePix. Wird Boleto, PIX oder BolePix angeboten, enthält das Feld außerdem ein Feld CPF or CNPJ. Es ist erforderlich, wenn keine Kreditkarte angeboten wird; andernfalls wird Required for boleto and PIX. angezeigt. Das Feld wird aus einem Zusatzfeld des Kunden oder aus der Adresse mit dem Namen CPF oder CNPJ vorausgefüllt, wenn dort eine gültige Nummer steht. Die Nummer wird anhand ihrer Prüfziffern geprüft. Fehlt etwas, sieht der Kunde Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. oder Please enter your CPF or CNPJ — it is required for boleto and PIX. Unter OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options; das Zahlungsfeld mit diesen Feldern und der Schaltfläche Confirm Order befinden sich unten auf der Checkout-Seite.

Wenn der Kunde auf Confirm Order klickt, legt die Erweiterung für diesen Warenkorb einen Vindi-Kunden aus der Zahlungsadresse an und eine Vindi-Rechnung über die Bestellsumme, in einer einzigen Rate. In Vindi heißt die Rechnung Order # mit der OpenCart-Bestellnummer.

Kreditkarte: Der Kunde wird zur Vindi-Rechnungsseite geschickt und bezahlt dort. Die Bestellung bleibt ohne Status. Vindi hat für Rechnungen keine Rückkehr-URL, daher wird der Kunde nicht automatisch in den Shop zurückgeleitet. Die Bestellung erhält ihren Status, wenn Vindi die Zahlung über den Webhook bestätigt. Bestätigt der Kunde die Bestellung mit demselben Warenkorb erneut und die Rechnung ist bereits bezahlt, wird die bezahlte Bestellung bestätigt und der Kunde sieht die Erfolgsseite.

Boleto, PIX und BolePix: Die Rechnung wird sofort ausgestellt, die Bestellung erhält den Status „ausstehend“, und der Kunde landet auf der Erfolgsseite der OpenCart-Bestellung. Dort und in den Bestelldetails im Kundenkonto zeigt ein Abschnitt Payment den PIX-QR-Code, den PIX-Kopier- und Einfügecode mit einer Schaltfläche Copy code und dessen Ablaufdatum sowie eine Schaltfläche Open boleto. Die Bestell-E-Mail und der Bestellverlauf des Kunden enthalten den PIX-Code und den Boleto-Link. Liefert Vindi die Boleto- oder PIX-Daten nicht, wird die Rechnung storniert und der Kunde sieht einen Fehler.

Die Bestellung wird erst als bezahlt markiert, nachdem Vindi die Zahlung bestätigt hat: Die Erweiterung ruft die Rechnung über die Vindi-API ab und prüft die Währung, ob die Rechnung zur Bestellung gehört (Rechnungscode und Vindi-Kunde) und ob der bezahlte Betrag der Bestellsumme entspricht. Die Erfolgsseite und die Bestellseite im Kundenkonto prüfen eine wartende Bestellung höchstens alle 15 Sekunden erneut über die API. Ist die Zahlung eingegangen, zeigt die Erfolgsseite Your payment with Vindi has been received. Solange die Zahlung noch nicht bestätigt ist, zeigt sie We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. Bei einer stornierten Bestellung zeigt sie This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid.

Solange die Zahlung nicht bestätigt ist, zeigen die Erfolgsseite und die Bestellseite im Kundenkonto (bei einer wartenden oder zurückgehaltenen Bestellung) außerdem eine Schaltfläche Check payment status. Sie prüft die neueste Vindi-Rechnung der Bestellung. Eine bestätigte oder wartende Bestellung führt zurück zur Erfolgsseite mit ihren Zahlungsdaten. Ist die Rechnung noch unbezahlt, sagt der Abschnitt Payment: Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. und enthält die Schaltflächen Pay at Vindi, Check again und Back to checkout.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung im Checkout, daher bezahlt die Erweiterung einen Warenkorb nur einmal. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, wartet auf Boleto- oder PIX-Zahlung oder ist zurückgehalten, gelangt der Kunde zur Erfolgsseite, und es wird keine neue Rechnung ausgestellt. Ein neuer Versuch für dieselbe Bestellung verwendet ihre offene Vindi-Rechnung erneut, wenn Zahlungsart, Betrag und Umgebung gleich sind. Andernfalls wird die vorherige Rechnung bei Vindi storniert, bevor eine neue erstellt wird, sodass der Kunde denselben Warenkorb nicht zweimal bezahlen kann. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 hält die Bestellung im Checkout, bis die Erfolgsseite angezeigt wird. Nach einer abgelehnten Kartenzahlung oder einer stornierten Rechnung bezahlt der Kunde dieselbe Bestellung erneut. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen, kehrt der Kunde zum Checkout zurück, und der nächste Confirm Order bezahlt eine neue Bestellung: Eine stornierte Bestellung zeigt This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid., eine fehlgeschlagene Your Vindi payment attempt was rejected. You can try again below. Unter OpenCart 4 werden die Meldungen der Statusseite Payment, die zurück zum Checkout führen, über der Checkout-Seite angezeigt.

Kann Vindi die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel dass er CPF / CNPJ, die Rechnungsadresse (Straße, Postleitzahl, Ort und Bundesstaat sind für Boleto erforderlich), die E-Mail-Adresse oder die Telefonnummer prüfen soll, oder dass Vindi vorübergehend nicht verfügbar ist. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung nimmt Einzelzahlungen in einer einzigen Rate an. Sie unterstützt keine Abonnements oder wiederkehrenden Abrechnungen, keine gespeicherten Karten, keine Ratenzahlung und kein Kartenformular auf Ihrer Website: Die Karte wird immer auf der Vindi-Seite eingegeben. Hausnummer und Stadtteil sind nicht Teil der OpenCart-Adresse und werden daher nicht an Vindi übermittelt.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (Bestellung ohne Status): Eine Kartenzahlung wurde gestartet, und Vindi hat sie noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Unter OpenCart 4.1 kann eine solche Bestellung auch den Status Voided haben, den OpenCart setzt, wenn der Bestätigungsschritt erneut angezeigt wird; die Erweiterung zählt sie als Bestellung ohne Status.

Awaiting Vindi Payment Status (Standard Ausstehend): Eine Zahlung per Boleto, PIX oder BolePix wartet. Die Bestellung wechselt zu Order Status After Payment, wenn Vindi die Rechnung als bezahlt meldet.

Order Status After Payment (Standard In Bearbeitung): Die Zahlung wurde bestätigt. Die Bestellung erhält ihren Status auf die übliche OpenCart-Art, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Eine Notiz zeigt die Vindi-Rechnung, den Betrag und die Umgebung.

Vindi Payment On Hold Status (Standard Ausstehend): Die Vindi-Rechnung wird geprüft, die bezahlte Rechnung passt nicht zur Bestellung (Währung, Betrag, Rechnungscode oder Vindi-Kunde), oder die Rechnung wurde bezahlt, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Prüfen Sie die Bestellung und den Bestand und vervollständigen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Payment Error Status (Standard Fehlgeschlagen): Vindi hat den Zahlungsversuch einer wartenden Bestellung abgelehnt. Die Notiz zeigt den Grund des Acquirers, falls vorhanden. Der Kunde kann dieselbe Rechnung noch bezahlen, und eine spätere Zahlung verschiebt die Bestellung zu Order Status After Payment.

Canceled Status (Standard Storniert): Die Rechnung einer wartenden Bestellung wurde bei Vindi storniert. Wenn Sie in OpenCart eine Bestellung auf diesen Status setzen, wird auch ihre offene Vindi-Rechnung storniert, sodass sie nicht mehr bezahlt werden kann. Ist dies nicht möglich, fordert Sie eine Notiz auf, die Rechnung im Vindi-Dashboard zu stornieren.

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

Wird für eine Bestellung, die bereits bezahlt ist, oder für eine andere Bestellung eines bereits bezahlten Warenkorbs eine zweite Rechnung bezahlt, bleibt die Bestellung unverändert. Eine Notiz an der bezahlten Bestellung fordert Sie auf, eine Zahlung in Vindi zu erstatten. Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Tab VibeFox Vindi Gateway

Öffnen Sie unter Sales > Orders eine mit Vindi bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Tab VibeFox Vindi Gateway die Vindi bill, die Charge, die Umgebung (mit dem Kennzeichen Sandbox bei Sandbox-Zahlungen), die Payment method, den Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf, alle Bills of this cart und die Vindi notes der Bestellung. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Tab VibeFox Vindi Gateway den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Vindi. Bestätigen Sie die Frage Refund this amount through Vindi? This cannot be undone. Volle und teilweise Erstattungen von Karten- und PIX-Zahlungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen sind auf den Betrag begrenzt, den Vindi tatsächlich belastet hat; nach einer Abweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde bezahlt hat, nicht die Bestellsumme. Die Erstattung wird in der Umgebung der Zahlung (Live oder Sandbox) gesendet, daher muss der API-Schlüssel dieser Umgebung eingerichtet sein.

Eine volle Erstattung storniert außerdem die Rechnung bei Vindi und setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte wieder ins Lager zu buchen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Eine erfolgreiche Erstattung wird mit dem Vindi-Charge und dem Status dem Erstattungsverlauf und den Notizen hinzugefügt. Lehnen Vindi oder der Acquirer die Erstattung ab, zeigt der Tab den Fehler, und es wird keine Erstattung erfasst. Erstattungen sind verfügbar, sobald Vindi die Rechnung als bezahlt gemeldet hat.

Vindi kann Boleto-Zahlungen nicht erstatten. Der Tab zeigt Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Vindi. Im Vindi-Dashboard vorgenommene Erstattungen gelangen über den Webhook charge_refunded 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 Vindi Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit, über den Einstellungen. Geben 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) und 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-vindi 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).

Wenn der Schlüssel nicht akzeptiert wird, zeigt 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 nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt 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 Vindi im Checkout 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 als (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admin-Bereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits erstellte Rechnungen werden weiterhin durch den Vindi-Webhook bestätigt, und Erstattungen funktionieren.

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

Fehlerbehebung

Vindi erscheint nicht im Checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, der Kunde in BRL bezahlt, mindestens eine Zahlungsart unter Offered methods ausgewählt ist und der aktuelle Modus einen API-Schlüssel hat: Sandbox API key im Sandbox-Modus, Live API key im Live-Modus. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt oder die Shop-Währung nicht BRL ist. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status oder im Status „ausstehend“: Der Webhook funktioniert nicht. Prüfen Sie in Vindi, ob der Webhook im verwendeten Konto (Live oder Sandbox) existiert, ob seine URL genau der in den Einstellungen angezeigten entspricht, einschließlich des Tokens, und ob alle vier Ereignisse ausgewählt sind.

Der Webhook antwortet mit Forbidden: Das Token in der URL fehlt oder ist falsch. Kopieren Sie die URL erneut aus den Einstellungen.

Der Webhook antwortet mit Verification failed, retry later: Die Rechnung konnte nicht über die Vindi-API gelesen werden (zum Beispiel wurde der API-Schlüssel dieser Umgebung entfernt), der Warenkorb wurde im selben Moment durch eine andere Anfrage aktualisiert, oder der Bestellstatus konnte nicht gesetzt werden. Vindi sendet die Benachrichtigung erneut. Das Protokoll zeigt den Grund.

Die Webhook-URL zeigt im Browser Method not allowed: Das ist normal. Die URL akzeptiert nur Anfragen von Vindi.

Der Kunde sieht This payment method is temporarily unavailable: Vindi hat den API-Schlüssel abgelehnt. Prüfen Sie den Schlüssel des aktuellen Modus.

Der Kunde sieht nach Confirm Order einen Fehler: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Fehler werden auch protokolliert, wenn Debug log aus ist. Für Boleto muss die Rechnungsadresse Straße, Postleitzahl, Ort und Bundesstaat enthalten.

Bestellung ist im zurückgehaltenen Status: Lesen Sie die Notizen im Tab VibeFox Vindi Gateway (siehe Bestellstatus) und vervollständigen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Alte Sandbox-Bestellungen nach dem Wechsel auf Live: Jede Zahlung behält die Umgebung ihrer Rechnung. Prüfungen, Stornierungen und Erstattungen von Sandbox-Bestellungen verwenden weiterhin den Sandbox-Schlüssel, solange er in den Einstellungen steht.

Erstattung schlägt fehl: Lesen Sie die Meldung. Boleto-Zahlungen können nicht über Vindi erstattet werden, und der API-Schlüssel der Umgebung der Zahlung muss eingerichtet sein. Ohne das Recht, die Erweiterung zu ändern, zeigt der Tab You do not have permission to refund orders (modify this extension).

Für Entwickler: Bevor der Vindi-Kunde und die Rechnung erstellt werden, löst die Erweiterung die OpenCart-Ereignisse wc_vdi_customer_request und wc_vdi_bill_request mit den Anfragedaten und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Vindi 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. Außerdem werden die OpenCart-Ereignisse der Erweiterung entfernt (unter OpenCart 4 auch ihre Startaktion, die im Wartungsmodus den Webhook und die Zahlungsstatusseite durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Einstellungen (Titel, Beschreibung, Sandbox-Modus, API-Schlüssel, Zahlungsarten, Protokollierung), das Webhook-Token, der Produkt-Cache und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Vindi-Rechnungen und Erstattungen der Bestellungen bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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