VibeFox 2C2P for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 6.0 oder neuer, installiert und aktiv. Ohne WooCommerce zeigt das Plugin einen Hinweis im Adminbereich, und die Zahlungsmethode wird nicht geladen.
PHP: 8.0 oder neuer.
2C2P-Konto: Sie benötigen die Merchant ID und den Secret Key Ihres 2C2P-Händlerkontos. 2C2P stellt sie bei der Eröffnung des Händlerkontos aus. Sandbox- und Live-Konten haben unterschiedliche Schlüssel. Entwicklerdokumentation und Testkarten für die Sandbox finden Sie auf developer.2c2p.com.
Währung: die Shopwährung muss vom Plugin unterstützt und in Ihrem 2C2P-Konto aktiviert sein. Unterstützt werden unter anderem THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR und GBP. Wird die Shopwährung nicht unterstützt, wird die Zahlungsmethode an der Kasse ausgeblendet.
VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt für eine Domain.
Installation
1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_2c2p_payment per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > 2C2P > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Geben Sie die Sandbox Merchant ID und den Sandbox Secret Key ein, schalten Sie Enable/Disable ein und führen Sie eine Testbestellung durch.
6. Wenn Sie so weit sind, geben Sie die Live-Zugangsdaten ein und entfernen Sie das Häkchen bei Sandbox Mode.
Die Rückkehr- und Benachrichtigungs-URLs werden mit jeder Zahlung übermittelt. Im 2C2P-Portal muss nichts eingerichtet werden.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > 2C2P. Über den Feldern zeigt die Seite bei eingeschaltetem Sandbox-Modus Sandbox mode is active. No real transactions will be processed. an. Sie warnt, wenn das Gateway aktiviert ist, aber Merchant ID oder Secret Key des aktuellen Modus leer sind, und wenn die Shopwährung nicht unterstützt wird. In beiden Fällen wird die Zahlungsmethode an der Kasse ausgeblendet. Wenn Sie mit ausgeschaltetem Sandbox Mode speichern, fragt das Plugin nach der Live Merchant ID und dem Live Secret Key, sofern diese leer sind.
Allgemein
Enable/Disable: Enable 2C2P Payment Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: 2C2P Payment.
Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. Im Sandbox-Modus wird (TEST MODE) ergänzt.
Testmodus (Sandbox)
Sandbox Mode: Enable sandbox / test mode leitet Zahlungen mit den unten stehenden Sandbox-Zugangsdaten an die 2C2P-Sandbox (demo2.2c2p.com). Standard: ein. Entfernen Sie das Häkchen, um echte Zahlungen anzunehmen.
Sandbox Merchant ID: Ihre Sandbox-Merchant-ID bei 2C2P.
Sandbox Secret Key: Ihr Sandbox-Secret-Key bei 2C2P.
Live-API-Zugangsdaten
Werden verwendet, wenn der Sandbox-Modus ausgeschaltet ist.
Merchant ID: Ihre Live-Merchant-ID bei 2C2P. Erforderlich, wenn der Sandbox-Modus ausgeschaltet ist.
Secret Key: Ihr Live-Secret-Key bei 2C2P. Erforderlich, wenn der Sandbox-Modus ausgeschaltet ist. Der Schlüssel wird genau so gespeichert, wie eingegeben, einschließlich Anführungszeichen und Backslashes.
Zahlungsseite
Dieser Abschnitt zeigt zur Information die Rückkehr-URL für das Frontend (https://your-site/?wc-api=tc2p_p) und die Benachrichtigungs-URL für das Backend (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1). Sie werden mit jeder Zahlung automatisch übermittelt.
Payment Page Language: die Sprache der 2C2P-Zahlungsseite. Standard: English.
Redirect API version: belassen Sie 8.5, sofern 2C2P Ihnen nicht mitgeteilt hat, dass Ihr Konto noch die alte Version 7.0 (SHA-1-Signaturen) verwendet. Ergebnisse von Zahlungen, die vor einem Wechsel gestartet wurden, werden weiterhin geprüft.
Order ID prefix: optional, nur Buchstaben und Ziffern (maximal 10), zum Beispiel SHOP1. 2C2P lehnt eine Bestellnummer ab, die bereits verwendet wurde. Legen Sie ein eindeutiges Präfix fest, wenn mehrere Shops ein 2C2P-Konto teilen, und im Sandbox-Modus, in dem Test-Händlerkonten gemeinsam genutzt werden. Andere Zeichen werden beim Speichern mit einem Warnhinweis entfernt.
Erweiterte Einstellungen
Enable Logging: Log 2C2P events schreibt in WooCommerce > Status > Logs, Quelle wcp_2c2p_payment. Es werden keine Kartendaten oder Secret Keys protokolliert. Standard: aus.
Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig 2C2P Payment) und gibt die Bestellung auf. Die nächste Seite zeigt Thank you for your order. You will be redirected to 2C2P to complete your payment. und leitet den Kunden nach kurzer Zeit zur Zahlungsseite von 2C2P weiter. Geschieht das nicht, klickt der Kunde auf Pay via 2C2P. Die Seite hat außerdem eine Schaltfläche Cancel order.
Auf der 2C2P-Seite bezahlt der Kunde mit jeder Methode, die in Ihrem 2C2P-Konto aktiviert ist, zum Beispiel Karten, E-Wallets, QR-Zahlungen, Online-Banking oder Barzahlung. Das Plugin übergibt den Bestellbetrag in der Bestellwährung, die Rechnungs-E-Mail-Adresse des Kunden und die Namen der bestellten Produkte. Die Zahlung kann innerhalb von 24 Stunden abgeschlossen werden.
2C2P meldet das Ergebnis zweimal: Der Browser des Kunden kehrt in den Shop zurück, und 2C2P sendet eine Server-zu-Server-Benachrichtigung. Beide werden gleich behandelt. Die Bestellung wird erst als bezahlt markiert, wenn 2C2P die Zahlung mit gültiger Signatur bestätigt. Das Ergebnis muss außerdem zur Bestellung gehören: Merchant ID, Bestellschlüssel (order key), Bestellnummer und Zahlungsmethode werden geprüft. Ergebnisse ohne gültige Signatur werden abgelehnt.
Nach einer erfolgreichen oder ausstehenden Zahlung landet der Kunde auf der Seite „Bestellung eingegangen“, und der Warenkorb wird geleert. Wurde die Zahlung nicht abgeschlossen, kehrt der Kunde zur Kasse zurück, mit der Meldung Payment was not completed. Please try again or choose a different payment method. Die Bestellung wird storniert, der Warenkorb bleibt erhalten, und der Kunde gibt eine neue Bestellung auf. Lässt sich das Ergebnis nicht bestätigen, sieht der Kunde We could not confirm the payment result. If your account was charged, please contact us before paying again.
Die Zahlungsmethode funktioniert an der klassischen Kasse und am Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin bietet keine Erstattungen aus WooCommerce, keine gespeicherten Karten, keine wiederkehrenden Zahlungen oder WooCommerce Subscriptions, keine Kartenfelder auf Ihrer Website und keine Unterstützung für die 2C2P PGW 4.x API.
Bestellungen
Bestellstatus
Pending payment: der Kunde wurde zu 2C2P weitergeleitet, und noch ist kein Ergebnis eingegangen.
Processing or Completed: 2C2P hat eine erfolgreiche Zahlung gemeldet (Status 000). WooCommerce setzt „In Bearbeitung“, bei Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten „Abgeschlossen“. Die Bestellnotiz zeigt die 2C2P-Transaktion, den Genehmigungscode, das Datum und den Zahlungskanal. Die Transaktions-ID ist die 2C2P-Transaktionsreferenz.
On hold: die Zahlung ist bei 2C2P ausstehend (Status 001), zum Beispiel eine Barzahlung, die der Kunde noch nicht geleistet hat. Die Bestellung wird als bezahlt markiert, sobald 2C2P die Zahlung meldet. Eine Bestellung wird ebenfalls auf „Wartend“ gesetzt, wenn 2C2P einen anderen Betrag oder eine andere Währung meldet als den Bestellbetrag. Die Bestellnotiz zeigt die erhaltenen und die erwarteten Werte. Prüfen Sie die Bestellung und die Transaktion im 2C2P-Portal.
Cancelled: die Zahlung wurde abgelehnt, vom Kunden abgebrochen oder ist fehlgeschlagen (Status 002, 003, 999). Die Bestellnotiz zeigt den Status und den Grund.
Eine bezahlte oder erstattete Bestellung wird durch ein späteres Ergebnis nie geändert, und ein wiederholtes altes Ergebnis öffnet eine von Ihnen stornierte Bestellung nicht erneut.
Erstattungen
Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie die Zahlung im 2C2P-Händlerportal und legen Sie danach in WooCommerce eine manuelle Erstattung an.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > 2C2P. 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 gilt für eine 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 2C2P Kunden an der Kasse nicht angezeigt. Versucht trotzdem jemand, eine Zahlung zu starten, 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. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
2C2P erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus eine Merchant ID und einen Secret Key hat: im Sandbox-Modus die Sandbox-Felder, im Live-Modus die Live-Felder. Prüfen Sie, ob die Shopwährung unterstützt wird. Die Einstellungsseite zeigt in beiden Fällen einen Warnhinweis.
Die Zahlung ist durchgegangen, aber die Bestellung bleibt bei Pending payment: kein gültiges Ergebnis hat Ihren Shop erreicht. Prüfen Sie, ob Merchant ID und Secret Key des aktuellen Modus zu dem 2C2P-Konto passen, mit dem die Zahlung erfolgte, und ob Redirect API version zu Ihrem Konto passt. Ein Ergebnis mit falscher Signatur oder für eine andere Merchant ID wird abgelehnt. Aktivieren Sie Enable Logging und suchen Sie in WooCommerce > Status > Logs nach Meldungen zu Hash oder Merchant ID. Prüfen Sie außerdem, ob Ihr Server Anfragen von 2C2P an die Benachrichtigungs-URL im Backend akzeptiert.
2C2P meldet, dass die Bestellnummer bereits existiert: 2C2P akzeptiert dieselbe Bestellnummer nicht zweimal. Das passiert, wenn mehrere Shops ein 2C2P-Konto teilen oder im Sandbox-Modus, in dem Demo-Händlerkonten von vielen Entwicklern gemeinsam genutzt werden. Legen Sie ein eindeutiges Order ID prefix fest.
Eine Zahlung wurde durchgeführt, aber die Bestellung ist On hold: entweder ist die Zahlung bei 2C2P noch ausstehend (zum Beispiel eine Barzahlung, die der Kunde noch nicht geleistet hat), oder der gezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein. Prüfen Sie die Bestellnotizen und die Transaktion im 2C2P-Portal.
Der Kunde sieht „This payment method is currently unavailable for this order“: die Bestellwährung wird nicht unterstützt, oder Merchant ID bzw. Secret Key des aktuellen Modus sind leer.
„Please enter your live Merchant ID“ oder „Please enter your live Secret Key“ beim Speichern: der Sandbox-Modus ist ausgeschaltet, und ein Live-Feld ist leer. Geben Sie die Live-Zugangsdaten ein oder lassen Sie Sandbox Mode eingeschaltet.
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
Beim Deaktivieren des Plugins bleiben alle Daten erhalten. 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, die 2C2P-Daten an den Bestellungen und die Protokolldateien werden nur entfernt, wenn Delete Data on Uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
2C2P ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit 2C2P verbunden noch von 2C2P empfohlen.