VibeFox Netopia for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv.

PHP: 8.0 oder neuer mit den Erweiterungen OpenSSL und DOM.

Währung: Die Shop- bzw. Bestellwährung muss RON, EUR, USD oder GBP sein. EUR, USD und GBP müssen in Ihrem Netopia-Konto aktiviert sein. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.

Netopia-Konto: Sie benötigen ein Netopia-Payments-Verkäuferkonto mit einem Verkaufspunkt. Aus den technischen Einstellungen benötigen Sie die Kontosignatur und für jede verwendete Umgebung (Sandbox und Live) das öffentliche Zertifikat (.cer) und den privaten Schlüssel (.key). Auf Netopia-Seite ist nichts einzurichten: Die IPN-Adresse wird mit jeder Zahlungsanfrage übermittelt.

Öffentliche Website: Die IPN-(Bestätigungs-)URL muss aus dem Internet erreichbar sein, nicht hinter einer Anmeldung, einer Basisauthentifizierung oder einer Wartungsseite. Bestellungen werden nur durch die Netopia-IPN aktualisiert.

VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Netopia Payments > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

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

5. Öffnen Sie im Netopia-Admin Ihren Verkaufspunkt, kopieren Sie die Kontosignatur und laden Sie Zertifikat und privaten Schlüssel der Sandbox- und der Live-Umgebung herunter. Fügen Sie die Signatur und den vollständigen Dateiinhalt in die Einstellungen ein (siehe Konfiguration).

6. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung im Sandbox-Modus und entfernen Sie danach das Häkchen bei Test mode, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Netopia Payments. Oberhalb der Felder warnt die Seite, wenn Kontosignatur, Zertifikat oder privater Schlüssel der aktiven Umgebung fehlen (die Zahlungsart wird dann an der Kasse ausgeblendet), und zeigt Test mode is on: payments go to the Netopia sandbox and no real money is charged. an, solange der Testmodus aktiv ist. In der Liste der Zahlungsarten ist Netopia als einrichtungsbedürftig markiert, bis die aktive Umgebung vollständig ist. Beim Speichern wird ein ungültiges Zertifikat oder ein ungültiger privater Schlüssel mit einer Fehlermeldung abgelehnt, und der bisherige Wert bleibt erhalten.

IPN (confirm) URL

Wird oben in den Einstellungen nur lesend angezeigt. Sie sieht etwa so aus: https://your-site/wc-api/netopia_payment_callback/. Sie wird mit jeder Zahlungsanfrage als Bestätigungs-URL übermittelt, daher müssen Sie sie nicht im Netopia-Admin eintragen. Netopia sendet die IPN an diese URL; das Plugin entschlüsselt sie mit dem privaten Schlüssel der aktiven Umgebung und prüft Ihre Kontosignatur sowie die Zahlungsanfrage. Netopia meldet diese Aktionen:

Eine Benachrichtigung mit einem Netopia-Fehlercode (zum Beispiel eine abgelehnte Karte) markiert eine unbezahlte Bestellung als Failed. Benachrichtigungen, die sich nicht entschlüsseln lassen, eine andere Kontosignatur tragen oder sich nicht auf eine Zahlungsanfrage dieser Bestellung beziehen, werden abgelehnt und ändern nichts.

Kasse

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

Title: der Titel der Zahlungsart, der an der Kasse angezeigt wird. Standard: Card Payment (Netopia).

Description: die Beschreibung der Zahlungsart, die an der Kasse angezeigt wird. Standard: Pay securely with your credit or debit card via Netopia.

Netopia-Konto

Im Netopia-Admin gehen Sie zu Seller accounts > your point of sale > Technical settings: Kopieren Sie die Kontosignatur und laden Sie das öffentliche Zertifikat (.cer) und den privaten Schlüssel (.key) jeder Umgebung herunter. Öffnen Sie die Dateien in einem Texteditor und fügen Sie den vollständigen Inhalt ein, einschließlich der BEGIN/END-Zeilen.

Account signature: die Verkäuferkontosignatur (Format XXXX-XXXX-XXXX-XXXX-XXXX), für Sandbox und Live dieselbe.

Test mode: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys. Schaltet Zahlungsseite und Schlüsselpaar um. Standard: ein. Deaktivieren Sie die Option, um mit den Live-Schlüsseln echte Zahlungen anzunehmen.

Sandbox public certificate (.cer): der Inhalt der öffentlichen Zertifikatsdatei der Sandbox. Er wird zum Verschlüsseln der Zahlungsanfrage verwendet.

Sandbox private key (.key): der Inhalt der privaten Schlüsseldatei der Sandbox. Er wird zum Entschlüsseln der IPN verwendet. Nach dem Speichern wird er nie wieder angezeigt; das Feld zeigt A private key is saved. Lassen Sie das Feld leer, um den gespeicherten Schlüssel zu behalten, oder fügen Sie einen neuen Schlüssel ein, um ihn zu ersetzen.

Live public certificate (.cer): der Inhalt der öffentlichen Zertifikatsdatei der Live-Umgebung.

Live private key (.key): der Inhalt der privaten Schlüsseldatei der Live-Umgebung. Nach dem Speichern wird er nie wieder angezeigt; lassen Sie das Feld leer, um den gespeicherten Schlüssel zu behalten.

Bestellungen

Order status after payment: der Status einer bezahlten Bestellung, die versendet werden muss. Bestellungen mit nur virtuellen oder herunterladbaren Artikeln schließt WooCommerce ohnehin ab. Der Status wird mit einer einzigen Statusänderung und einer einzigen E-Mail an den Kunden gesetzt.

Erweitert

Debug log: Log requests and IPN processing schreibt in WooCommerce > Status > Logs, Quelle wcp_netopia_gateway. Kartendaten, Schlüssel und Kundendaten werden nicht protokolliert. Fehler, zum Beispiel abgelehnte IPNs, werden immer protokolliert, auch wenn die Option aus ist. Standard: aus.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept). Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Card Payment (Netopia)) und gibt die Bestellung auf. Die nächste Seite zeigt Redirecting you to Netopia for secure payment… und leitet den Kunden automatisch zur Zahlungsseite von Netopia weiter; ersatzweise stehen die Schaltflächen Proceed to payment und Cancel order bereit. Die Zahlungsanfrage wird mit Ihrem Netopia-Zertifikat verschlüsselt und enthält den Bestellbetrag in der Bestellwährung, Order # mit der Bestellnummer sowie die Rechnungs- und Versandangaben. Im Sandbox-Modus geht die Anfrage an die Netopia-Sandbox.

Der Kunde bezahlt mit Karte auf der Netopia-Seite und kehrt zur Bestellbestätigungsseite Ihres Shops zurück. Die Rückkehr allein markiert die Bestellung nicht als bezahlt. Die Bestellung wird erst als bezahlt markiert, nachdem Netopia die Zahlung per IPN bestätigt hat. Bis dahin zeigt die Bestellbestätigungsseite Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. Bei einer Bestellung im Status On hold erscheint Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. Wurde die Zahlung abgebrochen, erscheint The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time.

Wird die Karte abgelehnt, wird die Bestellung als Failed markiert, und der Kunde kann sie über die Bestellseite erneut bezahlen. Ist das Plugin nicht richtig eingerichtet, zeigt die Zahlungsseite Netopia gateway is not configured properly. Please contact the store administrator.

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

Das Plugin akzeptiert Kartenzahlungen ausschließlich über das Kartenprotokoll Netopia v1. Erstattungen oder Erfassungen über WooCommerce gibt es nicht, ebenso keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements, Ratenzahlungen, SMS-, Banküberweisungs- oder Kryptozahlungen und kein Netopia API v2.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Netopia weitergeleitet, oder Netopia hat die IPN noch nicht gesendet.

Processing or Completed: Netopia hat die Zahlung bestätigt. Der Status richtet sich nach Order status after payment. Die Bestellnotiz zeigt den Betrag, die maskierte Kartennummer und die Netopia-Transaktion; Sandbox-Zahlungen sind mit [sandbox] gekennzeichnet. Die Transaktions-ID ist die Netopia-Transaktion.

On hold: Die Zahlung ist eine Vorautorisierung, die auf die Erfassung im Netopia-Admin wartet, oder sie wird bei Netopia geprüft. Die Bestellung wird als bezahlt markiert, sobald Netopia die Zahlung bestätigt. Eine Bestellung wird außerdem auf On hold gesetzt, wenn Rechnungsbetrag oder Währung von der Bestellung abweichen, wenn nur ein Teil der Zahlung erfasst wurde oder wenn Netopia die Zahlung einer stornierten Bestellung bestätigt. Die Bestellnotiz erklärt es. Prüfen Sie die Transaktion im Netopia-Admin und schließen Sie die Bestellung ab oder erstatten Sie sie manuell.

Failed: Netopia hat einen Fehler gemeldet, zum Beispiel eine abgelehnte Karte. Der Kunde kann erneut bezahlen.

Cancelled: Netopia hat die Zahlung storniert, oder der Kunde hat vor dem Wechsel zu Netopia auf Cancel order geklickt.

Späte Benachrichtigungen stufen eine bezahlte Bestellung nie herab. Bestätigt Netopia eine weitere Zahlung zu einer bereits bezahlten Bestellung, weist eine Notiz Sie darauf hin, das Duplikat im Netopia-Admin zu erstatten.

Erstattungen

Erstattungen erfolgen nicht über WooCommerce: Das Kartenprotokoll Netopia v1 kennt keinen Erstattungsaufruf, daher gibt es keine Schaltfläche Refund via. Erstatten Sie die Transaktion im Netopia-Admin. Netopia sendet daraufhin eine Gutschrift-IPN, und das Plugin erfasst die Erstattung automatisch mit dem Grund Refund initiated by Netopia. in der Bestellung. Teilerstattungen belassen den Bestellstatus; ist nichts mehr zu erstatten, setzt WooCommerce die Bestellung auf Refunded. Bei Bestellungen in EUR, USD und GBP wird der erstattete Betrag, den Netopia in RON meldet, in die Bestellwährung zurückgerechnet. Eine Erstattung wird nie doppelt erfasst und nie für mehr als den verbleibenden Betrag. Der Lagerbestand wird nicht automatisch wieder aufgefüllt.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > Netopia Payments. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich 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 den Domain-Platz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Netopia 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 Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und im Netopia-Admin vorgenommene Erstattungen werden weiterhin erfasst.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Netopia erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die aktive Umgebung vollständig ist (Account signature sowie Zertifikat und privater Schlüssel der Sandbox im Testmodus bzw. der Live-Umgebung im Live-Modus) und die Shop- bzw. Bestellwährung RON, EUR, USD oder GBP ist. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: Die IPN hat Ihren Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie, ob die IPN-(Bestätigungs-)URL aus den Einstellungen aus dem Internet erreichbar ist (kein Wartungsmodus, keine Basisauthentifizierung, keine Firewall). Aktivieren Sie Debug log und suchen Sie unter WooCommerce > Status > Logs, Quelle wcp_netopia_gateway, nach IPN-Einträgen. Die Rückkehr des Kunden allein markiert die Bestellung nie als bezahlt.

Log shows failed decrypting data: Der private Schlüssel passt nicht zum Zertifikat der Umgebung, die Netopia verwendet hat. Die IPN wird mit dem Schlüssel der aktiven Umgebung entschlüsselt und bei Zahlungen, die vor dem Wechsel des Testmodus gestartet wurden, mit dem Schlüssel der anderen Umgebung. Netopia versucht es erneut.

Log shows signature mismatch: Die Account signature weicht von dem Verkaufspunkt ab, der die IPN gesendet hat. Kopieren Sie sie erneut aus dem Netopia-Admin.

Log shows unknown payment request: Die IPN bezieht sich auf keine Zahlungsanfrage, die Ihr Shop für diese Bestellung in dieser Umgebung (Sandbox oder Live) gestellt hat. Es wird nichts geändert.

Log shows gateway not configured: Der private Schlüssel oder die Kontosignatur fehlt. Netopia wiederholt die IPN, und die Zahlung wird erfasst, sobald die Einstellungen vollständig sind.

Error on save about the certificate or private key: Der eingefügte Text ist kein gültiges Zertifikat bzw. kein gültiger Schlüssel. Fügen Sie den vollständigen Dateiinhalt einschließlich der BEGIN/END-Zeilen ein. Der bisherige Wert wurde beibehalten.

Order is On hold after payment: Lesen Sie die Bestellnotiz. Die Zahlung kann eine Vorautorisierung sein oder geprüft werden, Betrag oder Währung können abweichen, nur ein Teil wurde erfasst, die Bestellung war storniert, oder eine Sandbox-Zahlung wurde bestätigt, während der Shop im Live-Modus war (es wurde kein echtes Geld empfangen). Prüfen Sie die Transaktion im Netopia-Admin.

A refund made in Netopia does not appear on the order: Die Gutschrift-IPN hat den Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie das Protokoll. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce.

The license block shows an error: Folgen Sie der Meldung im Lizenzbereich. 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. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen einschließlich der gespeicherten Schlüssel 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.

Netopia Payments und mobilPay sind Marken ihrer jeweiligen Eigentümer. Dieses Plugin ist nicht mit Netopia Payments verbunden und wird von Netopia Payments nicht unterstützt.