VibeFox 2C2P for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

2C2P-Konto: Sie benötigen die Merchant ID und den Secret Key Ihres 2C2P-Händlerkontos. 2C2P stellt beides bei der Eröffnung Ihres Händlerkontos aus. Sandbox- und Live-Konten haben unterschiedliche Schlüssel. Die Entwicklerdokumentation und die Sandbox-Testkarten finden Sie auf developer.2c2p.com.

Währung: die Warenkorbwährung muss vom Modul 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 Warenkorbwährung nicht unterstützt, wird die Zahlungsmethode in der Kasse nicht angezeigt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls aus.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox 2C2P Payment in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite Configure in License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie Ihre Sandbox-Merchant-ID und Ihren Sandbox-Secret-Key ein, aktivieren Sie Enable/Disable, klicken Sie auf Save und legen Sie eine Testbestellung an.

5. Wenn Sie so weit sind, geben Sie die Live-Zugangsdaten ein und deaktivieren Sie Sandbox Mode.

Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting 2C2P payment und 2C2P payment on hold. PrestaShop aktiviert das neue Zahlungsmodul für alle Währungen, Länder und Kundengruppen. Sie können dies unter Payment > Preferences einschränken. Die Rückkehr- und Benachrichtigungs-URLs werden mit jeder Zahlung übermittelt. Im 2C2P-Portal muss nichts eingerichtet werden.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox 2C2P Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder zeigt die Seite Sandbox mode is active. No real transactions will be processed. an, solange der Sandbox-Modus aktiv ist. Sie wird gewarnt, wenn das Gateway aktiviert ist, aber die Merchant ID oder der Secret Key des aktuellen Modus leer ist, und wenn die Standardwährung des Shops nicht unterstützt wird. In beiden Fällen wird die Zahlungsmethode in der Kasse nicht angezeigt. Wenn Sie bei ausgeschaltetem Sandbox Mode speichern, zeigt das Modul Please enter your live Merchant ID. oder Please enter your live Secret Key., sofern ein Live-Feld leer ist. Die Einstellungen werden dennoch gespeichert.

2C2P

Enable/Disable: Enable 2C2P Payment Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden in der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: 2C2P Payment.

Description: der Text, der in der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. Im Sandbox-Modus wird (TEST MODE) angehängt.

Testmodus (Sandbox)

Sandbox Mode: sendet Zahlungen an die 2C2P-Sandbox (demo2.2c2p.com) mit den unten eingetragenen Sandbox-Zugangsdaten. Standard: ein. Schalten Sie dies aus, um echte Zahlungen anzunehmen.

Sandbox Merchant ID: Ihre 2C2P-Merchant-ID für die Sandbox.

Sandbox Secret Key: Ihr 2C2P-Secret-Key für die Sandbox.

Live-API-Zugangsdaten

Werden verwendet, wenn der Sandbox-Modus ausgeschaltet ist.

Merchant ID: Ihre Live-Merchant-ID bei 2C2P.

Secret Key: Ihr Live-Secret-Key bei 2C2P. Der Schlüssel wird genau so gespeichert, wie er eingegeben wurde, einschließlich Anführungszeichen und Backslashes.

Gespeicherte Secret Keys werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie den Schlüssel ändern möchten.

Gespeicherte Secrets löschen: Setzen Sie ein Häkchen bei Sandbox Secret Key oder Secret Key und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert bei.

Ergebnisse werden immer mit der Merchant ID und dem Secret Key des Modus geprüft, in dem die Zahlung erfolgte. Eine im Sandbox-Modus gestartete Zahlung wird nach dem Wechsel auf Live weiterhin mit dem Sandbox-Schlüssel geprüft, und ein mit dem Schlüssel des anderen Modus signiertes Ergebnis wird abgelehnt.

Zahlungsseite

Ergebnis-URLs: zeigt zur Information die Frontend return URL und die Backend notification URL. Mit suchmaschinenfreundlichen URLs sehen sie etwa so aus: https://your-shop/module/wcp_2c2p_payment/return und https://your-shop/module/wcp_2c2p_payment/notify, gegebenenfalls mit einem Sprachcode wie /en/. Sie werden bei jeder Zahlung automatisch übermittelt.

Payment Page Language: die Sprache der 2C2P-Zahlungsseite. Standard: English.

Redirect API version: belassen Sie es bei 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 einer Umstellung 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 in der Sandbox, wo Test-Händlerkonten gemeinsam genutzt werden. Andere Zeichen werden beim Speichern mit einer Warnung entfernt.

Erweiterte Einstellungen

Enable Logging: schreibt 2C2P-Ereignisse in logs/tc2p_p_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Es werden keine Kartendaten, Secret Keys, Kunden-E-Mail-Adressen oder Zahlungstoken protokolliert. Standard: aus. Solange es ausgeschaltet ist, wird nichts geschrieben, auch keine Fehler.

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 es eingeschaltet, entfernt das Deinstallieren des Moduls die Gateway-Einstellungen und das Protokoll. Die 2C2P-Transaktionen, Bestellungen und die Bestellstatus des Moduls bleiben immer erhalten, damit ein spätes Ergebnis einer alten Zahlung auch nach einer Neuinstallation verarbeitet wird. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig 2C2P Payment) und bestätigt. 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 auf die 2C2P-Zahlungsseite weiter. Geschieht das nicht, klickt der Kunde auf Pay via 2C2P. Die Seite hat außerdem eine Schaltfläche Back to checkout. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Auf der 2C2P-Seite zahlt der Kunde mit jeder Methode, die in Ihrem 2C2P-Konto aktiviert ist, etwa Karten, E-Wallets, QR-Zahlungen, Online-Banking oder Barzahlung. Das Modul übermittelt den Warenkorbbetrag in der Warenkorbwährung, die E-Mail-Adresse des Kunden und die Namen der Produkte im Warenkorb. Die Zahlung kann innerhalb von 24 Stunden abgeschlossen werden. Jeder Zahlungsversuch erhält eine eigene 2C2P-Bestellnummer (die Warenkorbnummer und die Nummer des Versuchs, nach dem optionalen Präfix), weil 2C2P dieselbe Bestellnummer nie zweimal akzeptiert.

2C2P meldet das Ergebnis zweimal: Der Browser des Kunden kehrt zum 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 Zahlung gehören: Die 2C2P-Bestellnummer muss von Ihrem Shop vergeben worden sein, und die Merchant-ID sowie das zufällige Token des Versuchs werden geprüft. Ergebnisse ohne gültige Signatur werden abgelehnt. Die Benachrichtigung funktioniert auch, wenn der Shop im Wartungsmodus ist, und sie wird nicht durch die Ländereinschränkung Ihres Shops blockiert.

Nach einer erfolgreichen Zahlung wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite mit Your 2C2P payment has been received. Bei einer ausstehenden Zahlung zeigt die Seite Your 2C2P payment is pending (for example a cash or bank payment that is not made yet). The order will be processed as soon as 2C2P confirms the payment. Bei einer Bestellung in Wartestellung zeigt sie Your payment was received and is being reviewed by the shop. Wurde eine ausstehende Zahlung später storniert, erscheint Your 2C2P payment was not completed. Please contact us about this order.

Wurde die Zahlung nicht abgeschlossen, wird keine Bestellung angelegt. Der Kunde kehrt zur Kasse zurück, mit der Meldung Payment was not completed. Please try again or choose a different payment method. Der Warenkorb bleibt erhalten, und der Kunde kann erneut zahlen oder eine andere Zahlungsmethode wählen. Kann das Ergebnis nicht bestätigt werden, sieht der Kunde We could not confirm the payment result. If your account was charged, please contact us before paying again. Kann die Zahlung nicht gestartet werden, zum Beispiel weil die Warenkorbwährung nicht unterstützt wird, lautet die Meldung This payment method is currently unavailable for this order. Please contact us or choose another payment method.

Hat der Warenkorb bereits eine Bestellung (bezahlt oder wartend auf eine ausstehende Zahlung), wird kein zweites Zahlungsformular erzeugt. Der Kunde wird zur Bestellbestätigungsseite geleitet.

Das Modul bietet keine Erstattungen aus PrestaShop, keine gespeicherten Karten, keine wiederkehrenden Zahlungen oder Abonnements, keine Kartenfelder auf Ihrer Website und keine Unterstützung für die 2C2P PGW 4.x API.

Bestellungen

Bestellstatus

No order yet: Der Kunde wurde zu 2C2P geschickt, und noch ist kein Ergebnis eingegangen, oder die Zahlung ist fehlgeschlagen. Es existiert nur der Warenkorb.

Payment accepted: 2C2P hat eine erfolgreiche Zahlung gemeldet (Status 000). Die Zahlung wird mit der 2C2P-Transaktionsreferenz als Transaktions-ID erfasst. Eine private Notiz zur Bestellung zeigt die 2C2P-Transaktion, den Genehmigungscode, das Datum und den Zahlungskanal.

Awaiting 2C2P payment: Die Zahlung ist bei 2C2P ausstehend (Status 001), zum Beispiel eine Barzahlung, die der Kunde noch nicht geleistet hat. Die Bestellung wechselt zu Payment accepted, sobald 2C2P die Zahlung meldet.

2C2P payment on hold: 2C2P hat einen anderen Betrag oder eine andere Währung gemeldet als die Bestellsumme. Die Notiz zeigt die erhaltenen und die erwarteten Werte. Prüfen Sie die Bestellung und die Transaktion im 2C2P-Portal.

Canceled: Eine ausstehende Zahlung wurde anschließend abgelehnt, storniert oder ist fehlgeschlagen (Status 002, 003, 999). Die Notiz zeigt den Status und den Grund. Ein fehlgeschlagenes Ergebnis eines älteren Versuchs storniert keine Bestellung, die durch einen anderen Versuch angelegt wurde.

Eine bezahlte Bestellung wird durch ein späteres Ergebnis nie verändert, und ein wiederholtes altes Ergebnis öffnet eine stornierte Bestellung nicht erneut. Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, dies zu prüfen und die doppelte Zahlung im 2C2P-Händlerportal zu erstatten.

2C2P-Zahlungsblock

Die Bestellseite zeigt einen Block 2C2P payment mit der 2C2P-Bestellnummer, der Transaktion, dem Zahlungsstatus, dem Kanal, dem Genehmigungscode, der maskierten Kartennummer, dem Datum, der Kanalantwort und dem erhaltenen Betrag sowie ein Badge Sandbox bei Sandbox-Zahlungen.

Erstattungen

Erstattungen aus PrestaShop werden nicht unterstützt. Erstatten Sie die Zahlung im 2C2P-Händlerportal und erfassen Sie die Erstattung anschließend manuell in PrestaShop.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox 2C2P Payment ist der erste Block auf Modules > Module Manager > VibeFox 2C2P Payment > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-2c2p und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (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. Nach einer Änderung der Shopadresse oder nachdem Sie in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul weiter mit dem zuletzt bekannten Status.

Ein Schlüssel funktioniert für eine Domain: die Domain des Hauptshops, auch bei einem Multistore-Setup. Wenn Sie den Schlüssel aus dem Shop entfernen, wird der Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird 2C2P den Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Zahlungsmethode auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber im Checkout nicht testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird beim Arbeiten im Back Office automatisch erneut geprüft: an den ersten 14 Tagen nach der Eingabe des Schlüssels einmal täglich, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren oder Zurücksetzen des Moduls werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

2C2P erscheint nicht in 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: die Sandbox-Felder im Sandbox-Modus, die Live-Felder im Live-Modus. Prüfen Sie, ob die Warenkorbwährung unterstützt wird. Die Einstellungsseite zeigt in beiden Fällen eine Warnung. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe freigegeben ist.

Die Zahlung ist erfolgt, aber es wurde keine Bestellung angelegt: Es ist kein gültiges Ergebnis bei Ihrem Shop angekommen. Prüfen Sie, ob Merchant ID und Secret Key des Modus, in dem die Zahlung erfolgte, zu Ihrem 2C2P-Konto passen und ob Redirect API version zu Ihrem Konto passt. Ein Ergebnis mit falscher Signatur oder für eine andere Merchant ID wird abgelehnt. Schalten Sie Enable Logging ein und suchen Sie im Feld Log nach Meldungen zu Hash oder Merchant ID. Prüfen Sie außerdem, ob Ihr Server Anfragen von 2C2P an die Backend-Benachrichtigungs-URL annimmt.

Die Backend-Benachrichtigung antwortet mit 400 FAIL: Das Ergebnis enthält fehlende Felder, eine falsche Signatur, eine andere Merchant ID oder ein falsches Token. 404 FAIL bedeutet, dass die 2C2P-Bestellnummer nicht von diesem Shop vergeben wurde. 503 RETRY bedeutet, dass die Bestellung im selben Moment von einer anderen Anfrage bestätigt wurde oder dass die Bestellung nicht angelegt werden konnte (zum Beispiel weil das Modul deaktiviert ist); 2C2P versucht es später erneut. Schalten Sie Enable Logging ein, um den Grund zu sehen.

Die Benachrichtigungs-URL zeigt im Browser FAIL an: Das ist normal. Die URL akzeptiert nur POST-Anfragen von 2C2P.

2C2P meldet, dass die Bestellnummer bereits existiert: 2C2P akzeptiert dieselbe Bestellnummer nicht zweimal. Das passiert, wenn mehrere Shops ein 2C2P-Konto teilen oder in der Sandbox, wo Demo-Händlerkonten von vielen Entwicklern gemeinsam genutzt werden. Legen Sie ein eindeutiges Order ID prefix fest.

Eine Zahlung wurde geleistet, aber die Bestellung steht auf Awaiting 2C2P payment oder 2C2P payment 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 Warenkorbwährung wird nicht unterstützt, die Merchant ID oder der Secret Key des aktuellen Modus ist leer, oder die Warenkorbsumme ist null.

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.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox 2C2P Payment und wählen Sie Uninstall. Lizenzschlüssel und Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete Data on Uninstall eingeschaltet, werden die Gateway-Einstellungen und das Protokoll entfernt. Ist es ausgeschaltet, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die 2C2P-Transaktionen und die Bestellstatus Awaiting 2C2P payment und 2C2P payment on hold bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

2C2P ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit 2C2P verbunden und wird nicht von 2C2P unterstützt.