VibeFox Flow for WooCommerce — Hilfe
Anforderungen
WordPress: 6.0 oder neuer.
WooCommerce: 8.0 oder neuer, installiert und aktiv.
PHP: 8.0 oder neuer.
Shop-Währung: Chilenischer Peso (CLP) oder US-Dollar (USD). Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet. Setzen Sie bei CLP-Shops WooCommerce > Settings > General > Number of decimals auf 0, da Flow ganze Pesos berechnet.
Flow-Konto: Sie benötigen API Key und Secret Key Ihres Flow-Kontos, bei Flow unter Mis datos, Datos técnicos. Erstellen Sie für Tests ein separates Sandbox-Konto auf sandbox.flow.cl und verwenden Sie dessen Schlüssel. Sandbox- und Live-Schlüssel sind unterschiedlich. Im Flow-Konto muss nichts eingerichtet werden.
Öffentliche Website: Die Bestätigungs-, Rückkehr- und Erstattungs-URLs Ihres Shops müssen aus dem Internet erreichbar sein, ohne Wartungsmodus, Passwortschutz oder eine Firewall, die Flow blockiert.
VibeFox-Lizenzschlüssel: Auf vibefox.net erworben. 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 und klicken Sie auf Install Now. Sie können den Ordner wcp_flow_gateway auch per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Flow.cl > 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 API Key und Secret Key der Sandbox ein, aktivieren Sie Enable / Disable, speichern Sie und geben Sie eine Testbestellung auf.
6. Um echte Zahlungen anzunehmen, tragen Sie die Live-Schlüssel ein und deaktivieren Sie Sandbox mode.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Flow.cl. Oberhalb der Felder warnt die Seite, wenn die Schlüssel des aktuellen Modus leer sind (Flow wird dann an der Kasse ausgeblendet), die Shop-Währung nicht unterstützt wird oder ein CLP-Shop Dezimalstellen verwendet (Flow berechnet ganze Pesos; setzen Sie deshalb Number of decimals auf 0, damit Preise, Gesamtbeträge und Erstattungen genau übereinstimmen). Im Sandbox-Modus erscheint Sandbox mode — Zahlungen gehen an sandbox.flow.cl, es wird kein echtes Geld belastet. In der Liste der Zahlungsmethoden wird Flow als einrichtungsbedürftig markiert, bis Schlüssel für den aktuellen Modus vorhanden sind; im Sandbox-Modus erscheint ein Testmodus-Abzeichen.
Allgemein
Enable / Disable: Enable Flow.cl payments schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: Der Name der Zahlungsmethode, den der Kunde an der Kasse sieht. Standard: Flow.
Description: Der unter der Zahlungsmethode an der Kasse angezeigte Text. Standard: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.
Flow-API-Zugangsdaten
Kopieren Sie API Key und Secret Key aus Ihrem Flow-Konto (Mis datos, Datos técnicos): Live-Schlüssel auf www.flow.cl, Sandbox-Schlüssel auf sandbox.flow.cl (separates Sandbox-Konto).
Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys. Im Sandbox-Modus wird kein echtes Geld belastet. Standard: an. Deaktivieren Sie ihn und tragen Sie die Live-Schlüssel ein, um echte Zahlungen anzunehmen. Erstattungen verwenden immer die Umgebung, in der die Bestellung bezahlt wurde.
Sandbox API Key: Der API Key Ihres Kontos auf sandbox.flow.cl.
Sandbox Secret Key: Der Secret Key Ihres Kontos auf sandbox.flow.cl. Er wird zum Signieren jeder Anfrage verwendet.
Live API Key: Der API Key Ihres Kontos auf www.flow.cl.
Live Secret Key: Der Secret Key Ihres Kontos auf www.flow.cl. Halten Sie ihn geheim.
Benachrichtigungen
Das Plugin sendet mit jeder Zahlung und Erstattung drei URLs an Flow, sodass im Flow-Konto nichts eingerichtet werden muss. Der Abschnitt listet sie auf:
Die Bestätigung enthält nur ein Zahlungstoken. Das Plugin fragt dann mit einer signierten Anfrage in der Umgebung, in der die Zahlung erstellt wurde, den Zahlungsstatus bei Flow ab und übernimmt ausschließlich die Antwort von Flow. Eine Zahlung, die dieser Shop nicht für die Bestellung erstellt hat, wird abgelehnt. Ohne Bestätigung wird die Bestellung aktualisiert, wenn der Kunde von Flow zurückkehrt.
Erweitert
Debug log: Log API calls and notifications unter WooCommerce > Status > Logs, Quelle wcp_flow_gateway, ohne Schlüssel oder Kundendaten. Fehler werden immer protokolliert. Standard: aus.
Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept). Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig Flow) und gibt die Bestellung auf. Im Sandbox-Modus zeigt die Kasse SANDBOX MODE — Zahlungen gehen an die Flow-Sandbox. Keine echten Belastungen. Eine gültige Rechnungs-E-Mail-Adresse ist erforderlich. Das Plugin erstellt eine Flow-Zahlung für den Bestellgesamtbetrag in der Bestellwährung mit dem Betreff Order # plus Bestellnummer und Website-Name und leitet den Kunden zur Flow-Zahlungsseite weiter. Dort wählt der Kunde eine in Ihrem Flow-Konto aktivierte Zahlungsmethode.
Nach der Zahlung kehrt der Kunde zu Ihrem Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Flow dies bestätigt: durch die Bestätigung oder durch eine signierte Statusanfrage bei der Rückkehr des Kunden. Eine bezahlte Bestellung oder ein noch nicht bezahlter Barzahlungsbeleg führt zur Bestelleingangsseite.
Wurde die Zahlung abgelehnt, kehrt der Kunde mit Your Flow payment was rejected. Please try again or choose another payment method. zur Seite Pay for order (oder zur Kasse) zurück. Hat der Kunde die Flow-Seite ohne Zahlung verlassen, lautet die Meldung The Flow payment was not completed. You can try again or choose another payment method. Konnte das Ergebnis nicht geprüft werden, lautet die Meldung We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. Jeder neue Versuch erstellt eine neue, an die Bestellung gebundene Flow-Zahlung.
Kann Flow die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel Could not connect to Flow. Please try again in a moment. Die Details stehen im Protokoll.
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. Die Kundentexte sind ins Spanische (Chile und Spanien) übersetzt.
Das Plugin akzeptiert nur einmalige Zahlungen. Es bietet keine gespeicherten Karten, Abonnements, wiederkehrenden Belastungen oder Zahlungslinks und wählt keine Flow-Zahlungsmethode vor. Flow kann einen bereits erstellten Zahlungslink nicht stornieren: Bezahlt ein Kunde einen alten Link nach einem neueren, erhält die Bestellung eine Notiz mit der Aufforderung, die doppelte Zahlung in Flow zu erstatten.
Bestellungen und Erstattungen
Bestellstatus
Pending payment: Der Kunde wurde zu Flow weitergeleitet und hat noch nicht bezahlt. Die Bestellnotiz zeigt den Betrag und die Flow-Bestellnummer des Versuchs.
On hold, awaiting coupon payment: Der Kunde hat einen Servipag- oder Multicaja-Zahlungsbeleg erstellt. Die Bestellung ändert sich, wenn Flow die Zahlung bestätigt.
Processing: Flow hat die Zahlung als bezahlt gemeldet, und Betrag und Währung stimmen überein (Bestellungen mit ausschließlich virtuellen herunterladbaren Produkten erhalten gemäß WooCommerce-Standard den Status Abgeschlossen). Die Bestellnotiz zeigt den Betrag und die Flow-Bestellnummer. Die Transaktions-ID der Bestellung ist die Flow-Bestellnummer.
On hold, amount/currency mismatch: Flow hat einen anderen Betrag oder eine andere Währung als die Bestellung gemeldet. Die Bestellung wurde nicht als bezahlt markiert; prüfen Sie sie manuell.
On hold, payment for a cancelled order: Eine Zahlung ist für eine Bestellung eingegangen, die ohne vorherige Zahlung storniert worden war. Prüfen und versenden Sie die Bestellung oder erstatten Sie die Zahlung in Flow.
Failed: Flow hat den letzten Zahlungsversuch einer unbezahlten Bestellung abgelehnt. Der Kunde kann es erneut versuchen.
Cancelled: Der letzte Zahlungsversuch wurde in Flow annulliert.
Geht eine weitere Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht verändert. Eine Notiz fordert Sie auf, die doppelte Zahlung in Ihrem Flow-Konto zu erstatten. Eine bezahlte und anschließend stornierte oder erstattete Bestellung wird nie wieder geöffnet.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Flow. Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird an die Umgebung gesendet, in der die Bestellung bezahlt wurde (Sandbox oder Live); daher müssen deren Schlüssel hinterlegt sein, und die Bestellung benötigt eine Rechnungs-E-Mail-Adresse. Flow sendet dem Kunden eine E-Mail zum Abschluss der Erstattung. Lehnt Flow die Erstattung ab, zeigt WooCommerce den Fehler an und erfasst keine Erstattung. Eine erfolgreiche Anfrage wird mit Flow-Erstattungsnummer und Status zu den Bestellnotizen hinzugefügt.
Spätere von Flow gemeldete Änderungen des Erstattungsstatus werden zu den Bestellnotizen hinzugefügt. Lehnt Flow eine Erstattung nachträglich ab oder storniert sie, besagt die Notiz, dass das Geld nicht an den Kunden zurückgezahlt wurde; der WooCommerce-Erstattungseintrag bleibt erhalten, bearbeiten Sie dies daher manuell. Im Flow-Dashboard erstellte Erstattungen werden nicht in WooCommerce importiert.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Flow.cl. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Ablaufdatum der Lizenz und Ihre Domain. Verwenden Sie Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um ihn von dieser Website zu entfernen. Der Link Manage licenses and domains in your account öffnet Ihr Konto auf vibefox.net.
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 Konto auf vibefox.net frei.
Ohne aktiven Schlüssel wird Flow den 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, gekennzeichnet mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Eine Erinnerung erscheint auf der Plugins-Seite und den WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.
Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung erforderlich. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
Flow erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv und Enable / Disable eingeschaltet ist, die Schlüssel des aktuellen Modus eingetragen sind (Sandbox-Schlüssel im Sandbox-Modus, Live-Schlüssel im Live-Modus) und die Shop-Währung CLP oder USD ist. Auf der Seite Pay for order wird die Bestellwährung geprüft.
Die Zahlung war erfolgreich, die Bestellung bleibt aber auf Pending payment: Die Flow-Bestätigung erreicht Ihren Shop nicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie, ob die in den Einstellungen angezeigte Bestätigungs-URL aus dem Internet erreichbar ist und nicht durch Wartungsmodus, Passwortschutz oder Firewall blockiert wird. Aktivieren Sie Debug log und sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_flow_gateway, nach.
Die Bestätigung antwortet mit Payment does not belong to the order oder Unknown order: Die Zahlung wurde nicht von diesem Shop für diese Bestellung erstellt oder stammt aus einer anderen Umgebung. Die Bestellung wird nicht verändert.
Die Bestätigung antwortet mit Gateway not configured: Die Schlüssel der Zahlungsumgebung sind leer. Tragen Sie sie erneut ein.
Die Bestätigung antwortet mit Flow API unavailable: Die Statusanfrage an Flow ist fehlgeschlagen. Flow wiederholt die Bestätigung.
Der Kunde sieht Flow payments are not available at the moment: Die Schlüssel fehlen oder wurden von Flow abgelehnt. Prüfen Sie API Key und Secret Key des aktuellen Modus.
Der Kunde sieht A valid billing email is required for Flow payments: Flow benötigt die E-Mail-Adresse des Kunden.
Der Kunde hat bezahlt, die Bestellung steht aber auf On hold: Lesen Sie die Bestellnotiz. Der Kunde hat einen noch unbezahlten Barzahlungsbeleg erstellt, oder der von Flow gemeldete Betrag beziehungsweise die Währung stimmt nicht mit der Bestellung überein. CLP-Gesamtbeträge mit Dezimalstellen werden auf ganze Pesos gerundet; setzen Sie daher Number of decimals auf 0.
Die Erstattung scheitert mit einer Meldung zu Sandbox- oder Live-Schlüsseln: Die Bestellung wurde in dieser Umgebung bezahlt, deren Schlüssel sind jedoch leer. Tragen Sie sie ein und versuchen Sie es erneut.
Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Wird der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet, geben Sie in Ihrem Konto auf vibefox.net einen Platz frei und klicken Sie auf Check now. Hat sich die Website-Adresse geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, funktioniert das Plugin mit dem letzten bekannten Status weiter.
Für Entwickler führt die readme den Filter wc_flw_supported_currencies auf (Währungen, für die das Gateway angeboten wird).
Deinstallation
Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Gateway-Einstellungen und Protokolle werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Auf Bestellungen gespeicherte Flow-Daten bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
Flow ist eine Marke des jeweiligen Eigentümers. Dieses Plugin ist weder mit Flow verbunden noch wird es von Flow unterstützt.