DE
EUR
Zurück

VibeFox Midtrans for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

Shop-Währung: Indonesische Rupiah (IDR). Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet. Es gibt keine Währungsumrechnung.

Midtrans-Konto: Sie benötigen den Server Key aus Midtrans Dashboard > Settings > Access Keys, im Sandbox-Dashboard und im Production-Dashboard. Nur der Server Key wird verwendet. Der Client Key wird für Snap Redirect nicht benötigt. Die Zahlungsmethoden selbst (GoPay, QRIS, virtuelle Konten und andere) werden in Ihrem Midtrans-Konto aktiviert.

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

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins aus und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_midtrans_payment_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Stellen Sie die Shop-Währung auf Indonesische Rupiah (IDR) ein.

4. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Midtrans > Manage, oder klicken Sie auf der Plugins-Seite unter dem Namen des Plugins auf Settings.

5. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

6. Tragen Sie die Server Keys ein und kopieren Sie die Zahlungsbenachrichtigungs-URL in das Midtrans-Dashboard (siehe Konfiguration).

7. Aktivieren Sie Enable/Disable. Testen Sie in Sandbox und stellen Sie dann Environment auf Production um.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Midtrans. Oberhalb der Felder warnt die Seite, wenn der Server Key der gewählten Umgebung fehlt (die Zahlungsmethode wird dann an der Kasse ausgeblendet) und wenn die Shop-Währung nicht IDR ist. Solange Sandbox gewählt ist, wird Sandbox mode: payments are simulated, no real money is charged. angezeigt. In der Liste der Zahlungsmethoden ist Midtrans als einrichtungsbedürftig markiert, bis ein Server Key eingetragen ist, und zeigt in Sandbox Test mode an.

General

Enable/Disable: Enable Midtrans payments schaltet die Zahlungsmethode ein oder aus. Standard: off.

Title: der Titel der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Midtrans.

Description: der Text, der an der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay securely via Midtrans — GoPay, QRIS, ShopeePay, cards, bank transfer and more. In Sandbox wird die Zeile SANDBOX MODE: no real money is charged. hinzugefügt.

API-Zugangsdaten

Kopieren Sie den Server Key aus Midtrans Dashboard > Settings > Access Keys. Der Bereich enthält Links zum Production- und zum Sandbox-Dashboard.

Environment: welche Midtrans-Umgebung für neue Zahlungen verwendet wird. Beim Umschalten werden der Schlüssel und die API der gewählten Umgebung verwendet. Bestellungen behalten die Umgebung, in der sie bezahlt wurden, für Erstattungen und Benachrichtigungen. Standard: Sandbox.

Sandbox: zum Testen, ohne echtes Geld.
Production: Live-Zahlungen.

Production Server Key: beginnt mit Mid-server-. Halten Sie ihn geheim.

Sandbox Server Key: beginnt mit SB-Mid-server-.

Zahlungsbenachrichtigungs-URL

Die Benachrichtigung teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Der Bereich zeigt die zu verwendende URL. Sie sieht etwa so aus: https://your-site/wc-api/midtrans_p_callback/. Fügen Sie sie unter Midtrans Dashboard > Settings > Payment > Notification URL ein, im Sandbox-Dashboard und im Production-Dashboard, das Sie verwenden. Öffnen Sie die URL im Browser, erscheint eine kurze Erklärung, sodass Sie prüfen können, ob sie erreichbar ist. Auch die Schaltfläche Test notification URL im Midtrans-Dashboard wird beantwortet.

Jede Benachrichtigung muss eine gültige Signatur tragen, die mit einem Ihrer Server Keys erstellt wurde, und die Umgebung des Schlüssels muss mit der Umgebung der Bestellung übereinstimmen. Benachrichtigungen ohne gültige Signatur werden abgelehnt. Der Status wird dann über die Status-API von Midtrans erneut abgefragt. Das Plugin verarbeitet diese Midtrans-Transaktionsstatus:

settlement, capture (accepted): die Zahlung wurde geleistet. Die Bestellung wird als bezahlt markiert, wenn Betrag (in ganzen Rupiah) und Währung übereinstimmen.
capture (challenge): eine Kartenzahlung, die von der Betrugserkennung von Midtrans markiert wurde. Die Bestellung wird auf Wartend gesetzt, bis Sie sie im Midtrans-Dashboard genehmigen oder ablehnen.
pending: der Kunde hat eine verzögerte Methode gewählt (virtuelles Konto, Convenience-Store) und noch nicht bezahlt. Die Bestellung wird auf Wartend gesetzt.
expire: die nicht bezahlte Transaktion ist abgelaufen. Die Bestellung wird storniert und der Lagerbestand freigegeben. Eine abgebrochene Kartenzahlung ändert die Bestellung nicht.
cancel: die Transaktion wurde storniert. Die Bestellung wird storniert.
deny: die Zahlung wurde abgelehnt. Eine zur Prüfung markierte Bestellung auf Wartend wird zu Fehlgeschlagen; andernfalls wird eine Notiz hinzugefügt und der Kunde kann es erneut versuchen.
failure: die Zahlung ist fehlgeschlagen. Die Bestellung wird zu Fehlgeschlagen.
refund, partial_refund: eine im Midtrans-Dashboard vorgenommene Erstattung wird als WooCommerce-Erstattung erfasst.

Ohne die Benachrichtigungs-URL wird eine Bestellung erst bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Zahlungseinstellungen

Midtrans rechnet nur in IDR ab, und Beträge werden in ganzen Rupiah übermittelt. Ergeben die Bestellpositionen nicht den gerundeten Gesamtbetrag, wird eine Zeile Rounding adjustment an Midtrans gesendet.

Status after payment: der Bestellstatus nach einer bestätigten Zahlung. Der Status wird in einem Schritt gesetzt, ohne doppelte E-Mails an den Kunden.

Processing: folgt den WooCommerce-Standardeinstellungen; Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten werden zu Abgeschlossen (Standard).
Completed: jede bezahlte Bestellung wird zu Abgeschlossen.
On hold: jede bezahlte Bestellung wartet auf Ihre manuelle Prüfung.

Payment page expiry (minutes): wie lange der Kunde zahlen kann (Snap-Seite, virtuelles Konto usw.). Leer lassen oder 0 eintragen für den Midtrans-Standard.

Order ID prefix: wird der an Midtrans gesendeten Bestellnummer vorangestellt, damit mehrere Shops ein Midtrans-Konto teilen können. Nur Buchstaben, Ziffern sowie - _ . ~, bis zu 20 Zeichen; andere Zeichen werden beim Speichern entfernt. Benachrichtigungen anderer Shops werden ignoriert. Standard: WC-.

Erweitert

Debug log: Log API calls and notifications schreibt nach WooCommerce > Status > Logs, Quelle wcp_midtrans_payment_gateway. Fehler werden immer protokolliert. Schlüssel und Kundendaten werden nie protokolliert. Standard: off.

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted (deactivation keeps everything). Order data is kept. Standard: off.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Midtrans) und gibt die Bestellung auf. Das Plugin erstellt eine Midtrans-Snap-Transaktion über den Bestellbetrag in ganzen Rupiah, mit den Bestellpositionen, dem Versand, den Steuern sowie den Rechnungs- und Lieferdaten des Kunden, und leitet den Kunden zur Zahlungsseite von Midtrans weiter. Dort wählt der Kunde eine beliebige Methode, die in Ihrem Midtrans-Konto aktiviert ist.

Nach der Zahlung kehrt der Kunde zur Bestellbestätigungsseite Ihres Shops zurück. Der Rücklink selbst markiert eine Bestellung nie als bezahlt: Das Plugin fragt die Status-API von Midtrans ab, und die Bestellung wird erst als bezahlt markiert, wenn Midtrans die Zahlung bestätigt. Solange die Zahlung nicht bestätigt ist, zeigt die Seite We are waiting for Midtrans to confirm your payment. If you chose a bank transfer, virtual account or convenience store, please complete the payment using the instructions from Midtrans. You will receive an e-mail once the payment is confirmed. Die Seite zeigt außerdem die verwendete Zahlungsmethode an.

Wurde die Zahlung nicht abgeschlossen, wird der Kunde zur Seite Pay for order geleitet, mit The Midtrans payment was not completed. You can try again below. Wurde sie abgelehnt oder ist sie abgelaufen, lautet die Meldung Your Midtrans payment was declined or has expired. Please try again or choose another payment method. Zahlt der Kunde erneut, wird ein nicht genutztes oder ausstehendes Snap über denselben Betrag wiederverwendet. Hat sich der Betrag geändert, wird zuerst die ausstehende Transaktion bei Midtrans verfallen lassen. Wurde das vorherige Snap inzwischen bezahlt, wird die Bestellung bestätigt und keine neue Transaktion erstellt.

Kann Midtrans die Zahlung nicht starten, sieht der Kunde Could not connect to Midtrans. Please try again in a moment., Midtrans payments are temporarily unavailable. Please choose another payment method or contact us. (zum Beispiel bei einem falschen Server Key) oder den Grund von Midtrans. Der technische Grund wird den Bestellnotizen hinzugefügt.

Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin verwendet nur Snap Redirect. Es gibt kein Snap-Popup, kein Kartenformular auf Ihrer Website, keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Einstellungen für Ratenzahlung oder Aktionen (Zahlungsmethoden konfigurieren Sie im Midtrans-Dashboard) und keine WooCommerce Subscriptions. Kartenzahlungen werden sofort erfasst, ohne getrennte Autorisierung und Erfassung.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: der Kunde wurde zu Midtrans weitergeleitet und hat noch keine Zahlungsmethode gewählt.

On hold: der Kunde hat eine verzögerte Methode gewählt und noch nicht bezahlt, die Kartenzahlung wird geprüft (challenge), oder der bezahlte Betrag bzw. die Währung stimmt nicht mit der Bestellung überein. Wartend wird auch gesetzt, wenn eine Zahlung für eine stornierte Bestellung eingeht; die Bestellung wird nicht automatisch wieder geöffnet. Die Bestellnotiz erklärt dies.

Processing, Completed or On hold after payment: die Zahlung wurde bestätigt. Der Status richtet sich nach Status after payment. Die Bestellnotiz zeigt die Zahlungsmethode und die Midtrans-IDs. Die Transaktions-ID ist die Midtrans-Transaktions-ID; in der Bestellansicht verlinkt sie auf die Transaktion im Midtrans-Dashboard der Umgebung der Bestellung.

Failed: die Zahlung ist fehlgeschlagen, oder eine zur Prüfung markierte Kartenzahlung wurde abgelehnt.

Cancelled: die nicht bezahlte Transaktion ist abgelaufen oder wurde storniert. Der Lagerbestand wird freigegeben. Wenn Sie eine nicht bezahlte Midtrans-Bestellung in WooCommerce stornieren (oder der Timer für unbezahlte Bestellungen dies tut), wird ihre ausstehende Midtrans-Transaktion, zum Beispiel ein ausgestelltes virtuelles Konto, verfallen gelassen, sodass sie nicht mehr bezahlt werden kann.

Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht erneut geändert. Eine Notiz fordert Sie auf, die zweite Zahlung im Midtrans-Dashboard zu erstatten. Eine Zahlung für eine erstattete Bestellung fügt nur eine Notiz hinzu.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Midtrans (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden in ganzen Rupiah unterstützt; ein Betrag mit Dezimalstellen wird abgelehnt. Die Erstattung wird in der Umgebung gesendet, in der die Bestellung bezahlt wurde, daher muss deren Server Key eingetragen sein. Midtrans erlaubt API-Erstattungen nur für einige Zahlungsmethoden und Transaktionsstatus (zum Beispiel abgerechnete Kartenzahlungen, GoPay, QRIS oder ShopeePay). Akzeptiert Midtrans die Erstattung nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst; erstatten Sie dann im Midtrans-Dashboard. Eine erfolgreiche Erstattung wird den Bestellnotizen hinzugefügt.

Im Midtrans-Dashboard vorgenommene Erstattungen kommen über die Benachrichtigung an und werden automatisch als WooCommerce-Erstattungen mit dem Grund Refunded in the Midtrans dashboard erfasst.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Midtrans. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Midtrans Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter; Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Midtrans erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die gewählte Environment ihren Server Key hat. Prüfen Sie, ob die Shop-Währung (oder die Bestellwährung auf der Seite „Pay for order“) IDR ist. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an.

Die Zahlung ging durch, aber die Bestellung bleibt im Status Pending payment: die Benachrichtigung funktioniert nicht. Prüfen Sie, ob die Zahlungsbenachrichtigungs-URL im Midtrans-Dashboard der verwendeten Umgebung (Sandbox oder Production) hinterlegt und erreichbar ist: Öffnen Sie sie im Browser, es erscheint eine kurze Erklärung. Aktivieren Sie das Debug log, um die Benachrichtigungen zu sehen. Die Bestellung wird auch bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Die Benachrichtigung antwortet Invalid signature: die Benachrichtigung wurde nicht mit Ihrem Sandbox- oder Production-Server-Key signiert. Prüfen Sie, ob die Schlüssel in den Einstellungen zu demselben Midtrans-Konto gehören wie das Dashboard, das die Benachrichtigungen sendet.

Die Benachrichtigung antwortet Server key not configured: es ist kein Server Key eingetragen. Tragen Sie ihn in den Einstellungen ein; Midtrans wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet Order not found — ignored: die Midtrans-Bestellnummer gehört zu keiner Bestellung dieses Shops, zum Beispiel stammt sie von einem anderen Shop auf demselben Midtrans-Konto. Geben Sie jedem Shop ein eigenes Order ID prefix.

Die Benachrichtigung antwortet Environment mismatch — ignored: die Benachrichtigung wurde mit dem Schlüssel einer anderen Umgebung signiert als derjenigen, in der die Bestellung bezahlt wurde.

Die Benachrichtigung antwortet Verification failed, please retry: die Status-API von Midtrans war nicht erreichbar. Midtrans wiederholt die Benachrichtigung.

Die Bestellung ist On hold: lesen Sie die Bestellnotiz. Der Kunde hat eine verzögerte Zahlung nicht abgeschlossen, die Kartenzahlung wird geprüft, oder der bezahlte Betrag bzw. die Währung stimmt nicht mit der Bestellung überein.

Der Kunde sieht beim Aufgeben der Bestellung einen Fehler: öffnen Sie die Bestellnotizen oder aktivieren Sie das Debug log und sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_midtrans_payment_gateway, nach. Eine Bestellung, die nicht in IDR erfolgt, zeigt Midtrans only supports payments in IDR (Indonesian Rupiah). Please choose another payment method.

Erstattung schlägt fehl: die Zahlungsmethode oder der Transaktionsstatus erlaubt keine API-Erstattungen; erstatten Sie im Midtrans-Dashboard, die Erstattung wird dann automatisch in WooCommerce erfasst. Wenn die Meldung besagt, dass für die Umgebung, in der die Bestellung bezahlt wurde, kein Server Key eingetragen ist, tragen Sie diesen Schlüssel ein und versuchen Sie es erneut.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und die Protokolle werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Midtrans ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Midtrans verbunden noch wird es von Midtrans unterstützt.