VibeFox Pin Payments for WooCommerce — Hilfe

Anforderungen

WordPress: 6.2 oder neuer.

WooCommerce: 7.1 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

HTTPS: Ihre Kasse muss HTTPS verwenden, wie für Kartenzahlungen erforderlich (PCI DSS). Kartendaten werden über Pin.js vom Browser des Kunden direkt an Pin Payments gesendet und erreichen nie Ihren Server, daher fällt der Shop unter PCI SAQ A-EP.

Pin-Payments-Konto: ein Pin-Payments-Händlerkonto (für Unternehmen in Australien oder Neuseeland; Kunden können von überall aus bezahlen). Sie benötigen dessen öffentlichen Schlüssel (Publishable Key) und geheimen Schlüssel (Secret Key), für den Live-Betrieb und zum Testen für die Testumgebung. Ein Webhook-Geheimnis ist nicht nötig: Das Plugin verwendet keine Webhooks.

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. Sie können auch den Ordner wcp_pinpayments_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Pin Payments > 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. Öffnen Sie im Pin-Payments-Dashboard Account > API Keys und kopieren Sie Ihre Testschlüssel in Test publishable key und Test secret key. Lassen Sie Test mode eingeschaltet, aktivieren Sie Enable/Disable und speichern Sie.

6. Führen Sie eine Testbestellung mit einer Pin-Payments-Testkarte durch. Wenn alles funktioniert, geben Sie die Live-Schlüssel ein, schalten Sie Test mode aus und speichern Sie.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Pin Payments. Oberhalb der Felder zeigt die Seite einen Hinweis, solange der Testmodus aktiv ist, einen Fehler, solange der öffentliche oder der geheime Schlüssel des aktuellen Modus leer ist, und einen Fehler, wenn Pin Payments die Shop-Währung nicht unterstützt (mit der Liste der unterstützten Währungen). In den beiden letzten Fällen wird die Zahlungsart auf der Kasse ausgeblendet. Nach dem Speichern zeigen die Hinweise bereits den neuen Modus und die neuen Schlüssel an. In der Liste der Zahlungsarten ist die Zahlungsart als einrichtungsbedürftig markiert, bis der aktuelle Modus beide Schlüssel hat.

Enable/Disable: Enable Pin Payments schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Titel der Zahlungsart, der auf der Kasse angezeigt wird. Standard: Credit card (Pin Payments).

Description: die Beschreibung der Zahlungsart, die auf der Kasse angezeigt wird. Standard: Pay with your credit card via Pin Payments.

API-Schlüssel

Ihre Schlüssel finden Sie im Pin-Payments-Dashboard unter Account > API Keys. Testschlüssel funktionieren nur mit der Test-API, Live-Schlüssel nur mit der Live-API. Der öffentliche Schlüssel wird von Pin.js im Browser des Kunden verwendet. Der geheime Schlüssel verlässt nie Ihren Server.

Test mode: Enable test mode. Verwendet die Testumgebung von Pin Payments (test-api.pinpayments.com) und die Testschlüssel. Es werden keine echten Belastungen durchgeführt, und Kunden sehen im Kartenformular TESTMODUS — es werden keine echten Belastungen durchgeführt. Ist er ausgeschaltet, werden die Live-API (api.pinpayments.com) und die Live-Schlüssel verwendet. Standard: ein.

Test publishable key: der öffentliche Schlüssel Ihres Pin-Payments-Testkontos.

Test secret key: der geheime Schlüssel Ihres Pin-Payments-Testkontos. Es ist ein Passwortfeld.

Live publishable key: der öffentliche Schlüssel Ihres Live-Kontos bei Pin Payments.

Live secret key: der geheime Schlüssel Ihres Live-Kontos bei Pin Payments. Es ist ein Passwortfeld.

Leerzeichen um die Schlüssel werden entfernt. Beide Schlüssel des aktuellen Modus müssen ausgefüllt sein, sonst wird die Zahlungsart auf der Kasse nicht angezeigt.

Erweitert

Debug log: Log Pin Payments API calls — Protokolle werden unter WooCommerce > Status > Logs mit der Quelle wcp_pinpayments_gateway gespeichert. Fehler werden immer protokolliert; aktivieren Sie diese Option, um zusätzlich jeden API-Aufruf zu protokollieren. Kartendaten, API-Schlüssel und personenbezogene Kundendaten werden nie protokolliert. Standard: aus.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Zahlungsdaten, die in Bestellungen gespeichert sind, bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit card (Pin Payments) mit den Symbolen für Visa, Mastercard und American Express) und füllt auf Ihrer Kasse Card number, Expiry (MM / YY), CVC und Name on card aus. Vor dem Absenden prüft das Kartenformular die Länge der Kartennummer, den Ablaufmonat und das Ablaufjahr, einen CVC mit 3 oder 4 Ziffern sowie den Namen.

Wenn die Bestellung aufgegeben wird, sendet Pin.js die Kartendaten und die Rechnungsadresse vom Browser direkt an Pin Payments und erhält ein einmalig verwendbares Kartentoken. Nur dieses Token wird an Ihren Server gesendet. Ihr Server erstellt dann eine erfasste Belastung über den Bestellbetrag in der Bestellwährung mit der Beschreibung <store name> - Order <number>. Pin Payments antwortet in derselben Anfrage. Die Bestellung wird erst als bezahlt markiert, wenn Pin Payments eine erfolgreiche Belastung meldet, und nur für genau den Bestellbetrag und die Bestellwährung. Danach gelangt der Kunde auf die Seite „Bestellung eingegangen“.

Pro Bestellung läuft jeweils nur ein Zahlungsversuch. Ein zweites Absenden erhält Diese Bestellung wird bereits bezahlt. Bitte warten Sie einen Moment und prüfen Sie Ihre E-Mails, bevor Sie es erneut versuchen. Eine bereits bezahlte oder belastete und zurückgehaltene Bestellung wird nie erneut belastet. Ein Kartentoken kann nur einmal verwendet werden: Nach einem fehlgeschlagenen Versuch oder wenn der Kunde die Kartendaten ändert, wird ein neues Token erstellt.

Meldungen, die der Kunde sehen kann: Ihre Karte wurde abgelehnt. Bitte verwenden Sie eine andere Karte oder kontaktieren Sie Ihre Bank.; Ihre Karte hat nicht genügend Deckung. Bitte verwenden Sie eine andere Karte.; Ihre Karte ist abgelaufen. Bitte verwenden Sie eine andere Karte.; Der Kartenprüfcode (CVC) ist falsch.; Diese Kartenart wird nicht akzeptiert. Bitte verwenden Sie Visa, Mastercard oder American Express.; Zahlung fehlgeschlagen: mit dem Grund von Pin Payments für die abgelehnten Daten; Ihre Kartendaten sind abgelaufen. Bitte geben Sie sie erneut ein und versuchen Sie es noch einmal., wenn das Token nicht verwendet werden kann; Das sichere Kartenformular konnte nicht geladen werden. Bitte laden Sie die Seite neu oder wählen Sie eine andere Zahlungsart., wenn Pin.js nicht lädt; Kartenzahlungen sind vorübergehend nicht verfügbar. Bitte versuchen Sie es später erneut oder wählen Sie eine andere Zahlungsart., wenn Pin Payments den geheimen Schlüssel ablehnt; Wir konnten Ihre Zahlung bei Pin Payments nicht bestätigen. Bitte prüfen Sie vor einem erneuten Versuch Ihre E-Mails und Ihre Kartenabrechnung oder kontaktieren Sie uns., wenn Pin Payments nicht antwortet. Technische Details werden in den Bestellnotizen und im Protokoll gespeichert.

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

Das Plugin hat keinen 3-D-Secure-Ablauf. Verlangt Ihr Pin-Payments-Konto 3-D Secure, bleibt die Belastung ausstehend und das Plugin markiert die Bestellung als fehlgeschlagen, sodass bei diesem Versuch kein Geld abgebucht wird; der Kunde sieht Ihre Kartenzahlung konnte nicht abgeschlossen werden (zusätzliche Verifizierung erforderlich). Bitte versuchen Sie eine andere Karte oder eine andere Zahlungsart. Es gibt keinen Modus nur mit Autorisierung und späterer Erfassung, keine gespeicherten Karten, keine WooCommerce Subscriptions, kein Apple Pay oder Google Pay und keine Webhooks.

Bestellungen und Erstattungen

Bestellstatus

Processing: Pin Payments meldete eine erfolgreiche, erfasste Belastung genau über den Bestellbetrag und die Bestellwährung. Bestellungen mit nur virtuellen, herunterladbaren Produkten werden auf Abgeschlossen gesetzt, der WooCommerce-Standard. Die Bestellnotiz zeigt den Betrag und das Belastungs-Token (und TEST MODE bei Testzahlungen). Die Transaktions-ID ist das Belastungs-Token von Pin Payments.

Failed: Die Karte wurde abgelehnt, die Belastung blieb ausstehend (3-D Secure), Pin Payments hat den geheimen Schlüssel oder die Anfrage abgelehnt. Jeder fehlgeschlagene Versuch fügt der Bestellung eine Notiz mit dem Fehlercode und der Meldung von Pin Payments hinzu, auch wenn die Bestellung durch einen früheren Versuch bereits auf Fehlgeschlagen stand. Der Kunde kann es mit derselben Bestellung erneut versuchen.

Pending payment: Pin Payments hat keine eindeutige Antwort gegeben (Zeitüberschreitung, Serverfehler, unlesbare Antwort). Die Bestellung wird nicht als fehlgeschlagen markiert, weil die Belastung trotzdem erstellt worden sein könnte. Die Notiz weist Sie an, die Belastungsbeschreibung im Pin-Payments-Dashboard zu suchen, bevor der Kunde erneut zahlt oder die Bestellung versandt wird. Dieser Status ist Zahlung ausstehend.

On hold: Pin Payments hat einen anderen Betrag oder eine andere Währung als bei der Bestellung belastet (die Notiz zeigt den erwarteten und den belasteten Betrag), oder die Belastung ist autorisiert, aber nicht erfasst. Prüfen Sie die Belastung im Pin-Payments-Dashboard, bevor Sie die Bestellung abwickeln.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Credit card (Pin Payments) (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird an die Umgebung (Test oder Live) gesendet, in der die Bestellung bezahlt wurde; deshalb muss der geheime Schlüssel dieses Modus gesetzt sein. Eine erfolgreiche Anfrage fügt der Bestellung eine Notiz mit Betrag, dem Erstattungs-Token von Pin Payments und dessen Status hinzu. Pin Payments verarbeitet Erstattungen asynchron, daher lautet der Status meist Pending. Lehnt Pin Payments die Erstattung ab oder antwortet nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst.

Im Pin-Payments-Dashboard vorgenommene Erstattungen werden nicht mit WooCommerce synchronisiert. Nehmen Sie Erstattungen deshalb immer in WooCommerce vor.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Pin Payments. 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 Pin Payments auf der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert als (unlizenziert — nur für Administratoren sichtbar), 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: Erstattungen funktionieren weiterhin.

Wenn eine Lizenz abläuft, arbeitet das Plugin weiter, Updates und Support benötigen aber eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Pin Payments erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, beide Schlüssel des aktuellen Modus ausgefüllt sind (Test publishable key und Test secret key im Testmodus, sonst die Live-Schlüssel) und die Warenkorbwährung eine der 14 unterstützten Währungen ist. Auf der Seite Pay for order zählt die Bestellwährung. Die Einstellungsseite zeigt einen Fehler bei fehlenden Schlüsseln und bei einer nicht unterstützten Währung an.

Auf der Kasse steht „Wir konnten Ihre Zahlung nicht bestätigen“: Pin Payments hat nicht rechtzeitig geantwortet. Die Bestellung bleibt mit einer Notiz auf Zahlung ausstehend. Suchen Sie im Pin-Payments-Dashboard nach einer Belastung mit der Beschreibung <store name> - Order <number>, bevor der Kunde erneut zahlt oder die Bestellung versandt wird. Das Plugin sucht eine solche Belastung nicht automatisch, und ein neuer Versuch erstellt eine neue Belastung.

Kunden sehen „Kartenzahlungen sind vorübergehend nicht verfügbar“: Pin Payments hat den geheimen Schlüssel abgelehnt. Die Bestellnotiz weist darauf hin, die Schlüssel des aktuellen Modus zu prüfen. Testschlüssel funktionieren nur im Testmodus, Live-Schlüssel nur im Live-Modus.

Bestellungen schlagen mit „zusätzliche Verifizierung erforderlich“ fehl: Ihr Pin-Payments-Konto verlangt 3-D Secure, was das Plugin nicht unterstützt. Bitten Sie Pin Payments, das verpflichtende 3-D Secure zu deaktivieren.

Eine Bestellung steht auf Wartend mit der Notiz „does not match“: Pin Payments hat einen Belastungsbetrag oder eine Währung gemeldet, die von der Bestellung abweicht. Prüfen Sie die Belastung im Pin-Payments-Dashboard und erstatten Sie die Bestellung oder schließen Sie sie manuell ab.

Das sichere Kartenformular konnte nicht geladen werden: Pin.js aus dem CDN von Pin Payments wurde im Browser nicht geladen, etwa wegen eines Script-Blockers oder eines Cache- oder Optimierungs-Plugins, das Skripte verändert. Schließen Sie die Kasse von solchen Optimierungen aus.

Erstattung schlägt fehl: Lesen Sie die Meldung. Eine Meldung zum TEST- oder LIVE-Modus bedeutet, dass der geheime Schlüssel des Modus, in dem die Bestellung bezahlt wurde, leer ist. Pin Payments hat die Erstattung nicht bestätigt bedeutet, dass keine Antwort kam; prüfen Sie die Belastung im Pin-Payments-Dashboard, bevor Sie es erneut versuchen.

Zahlung fehlgeschlagen mit einem Grund von Pin Payments: Pin Payments hat die Belastungsdaten abgelehnt, zum Beispiel einen Betrag unterhalb des Mindestbetrags für die Währung. Der Kunde sieht den Grund, und die Bestellnotiz enthält den Fehlercode.

Testzahlungen: Der Testmodus verwendet die Testumgebung und die Testschlüssel. Verwenden Sie die Testkarten aus der Entwicklerdokumentation von Pin Payments, zum Beispiel 4200 0000 0000 0000 (erfolgreich) oder 4100 0000 0000 0001 (abgelehnt), mit einem beliebigen zukünftigen Ablaufdatum und einem beliebigen CVC. Bestellungen behalten den Modus, in dem sie bezahlt wurden, sodass Erstattungen nach einem Moduswechsel in die richtige Umgebung gehen.

Wo Fehler zu finden sind: Fehler werden immer unter WooCommerce > Status > Logs mit der Quelle wcp_pinpayments_gateway geschrieben. Aktivieren Sie Debug log, um jeden API-Aufruf zu sehen.

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.

Für Entwickler: Der Filter wc_ppg_supported_currencies ändert die Währungsliste, und wc_ppg_icon ändert das Symbol in der WooCommerce-Liste der Zahlungsarten.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen der Zahlungsart, die Versionsoptionen des Plugins und seine Protokolle (Protokolldateien, auch rotierte, und Einträge in der Datenbank) werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Zahlungsdaten in Bestellungen, etwa das Belastungs-Token von Pin Payments, werden nie gelöscht. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Pin Payments ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Pin Payments verbunden und wird nicht von Pin Payments unterstützt.