VibeFox ePayco for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.
PHP: 8.0 oder neuer.
Shopwährung: kolumbianischer Peso (COP) oder US-Dollar (USD). Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.
ePayco-Konto: Sie benötigen die vier Schlüssel Ihres ePayco-Kontos: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY und PRIVATE_KEY. Sie finden sie im ePayco-Dashboard unter Integrations, API keys. Dieselben Schlüssel funktionieren im Test- und im Livemodus. Die Zahlungsarten, die Kunden nutzen können (Karten, PSE, Barzahlungsnetzwerke, Wallets), sind die in Ihrem ePayco-Konto aktivierten.
Öffentliche Website: Die Bestätigungs-URL Ihres Shops muss aus dem Internet erreichbar sein und darf nicht durch den Wartungsmodus, eine Firewall oder eine Basis-Authentifizierung blockiert werden.
VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. 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. Alternativ können Sie den Ordner wcp_epayco_payment per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > ePayco > Manage, oder klicken Sie auf der Plugins-Seite unter dem Namen des Plugins 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 vier ePayco-Schlüssel ein und wählen Sie den Checkout-Typ (siehe Konfiguration).
6. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung im Test Mode mit ePayco-Testkarten und deaktivieren Sie danach Test Mode.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > ePayco. Oberhalb der Felder warnt die Seite, wenn nicht alle vier Schlüssel eingegeben sind (dann wird die Zahlungsart an der Kasse ausgeblendet), wenn die Shopwährung weder COP noch USD ist, und zeigt Test mode is on: customers pay with ePayco test cards and no real money is charged. an, solange der Testmodus aktiviert ist. In der Liste der Zahlungsarten ist ePayco als einrichtungsbedürftig markiert, bis alle vier Schlüssel eingegeben sind.
Allgemein
Enable/Disable: Enable ePayco Payment schaltet die Zahlungsart ein oder aus. Standard: aus.
Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: ePayco.
Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay securely with ePayco.
ePayco-Kontoschlüssel
Die vier Schlüssel finden Sie im ePayco-Dashboard unter Integrations, API keys. P_CUST_ID_CLIENTE und P_KEY prüfen die Zahlungsbestätigungen; PUBLIC_KEY und PRIVATE_KEY erstellen die Checkout-Sitzungen. Dieselben Schlüssel funktionieren im Test- und im Livemodus.
Customer ID (P_CUST_ID_CLIENTE): Ihre ePayco-Kundennummer (numerisch).
Secret Key (P_KEY): dient zur Prüfung der Signatur von ePayco-Zahlungsbestätigungen. Bewahren Sie ihn geheim auf.
Public Key (PUBLIC_KEY): Ihr öffentlicher ePayco-API-Schlüssel.
Private Key (PRIVATE_KEY): Ihr privater ePayco-API-Schlüssel. Bewahren Sie ihn geheim auf.
Test Mode: Enable test mode erstellt Checkout-Sitzungen als Testtransaktionen. Kunden zahlen mit ePayco-Testkarten, und es wird kein echtes Geld belastet. Testtransaktionen bezahlen niemals Bestellungen, die im Livemodus angelegt wurden. Standard: aus.
Kasse
Checkout Type: wie sich der ePayco-Checkout öffnet.
Bestätigungs-URL
Die Bestätigungs-URL teilt Ihrem Shop das Ergebnis einer Zahlung mit. Sie wird bei jeder Zahlung automatisch an ePayco übermittelt, daher ist im ePayco-Dashboard nichts einzurichten. Der Bereich zeigt die URL. Sie sieht etwa so aus: https://your-site/wc-api/epc_p/. Sie muss aus dem Internet erreichbar sein und darf nicht durch den Wartungsmodus, eine Firewall oder eine Basis-Authentifizierung blockiert werden.
Jede Bestätigung muss eine gültige Signatur tragen, die mit Ihrer P_CUST_ID_CLIENTE und Ihrem P_KEY erstellt wurde. Bestätigungen ohne gültige Signatur werden abgelehnt und ändern die Bestellung nicht. Ohne die Bestätigung wird eine Bestellung nur aktualisiert, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.
Erweitert
Logging: Enable logging schreibt API-Fehler und Zahlungsbestätigungen nach WooCommerce > Status > Logs, Quelle wcp_epayco_payment. Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus.
Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. In Bestellungen gespeicherte ePayco-Daten bleiben erhalten. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsart (standardmäßig ePayco) und gibt die Bestellung auf. Das Plugin erstellt eine ePayco-Checkout-Sitzung für die Bestellsumme in der Bestellwährung mit den Bestellsteuern, der Bestellnummer sowie Rechnungsname, -adresse, E-Mail und Telefonnummer. Die Sprache des Checkouts ist Spanisch oder Englisch, je nach Sprache der Website. Danach landet der Kunde auf der Zahlungsseite der Bestellung, die Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. anzeigt. Der ePayco-Checkout öffnet sich je nach Checkout Type als Popup oder als Weiterleitung. Die Seite enthält außerdem die Schaltfläche Pay with ePayco und den Link Choose another payment method. Im Testmodus zeigen die Seite und der Checkout TEST MODE — use ePayco test cards, no real money is charged. an.
Im ePayco-Checkout bezahlt der Kunde mit einer der in Ihrem ePayco-Konto aktivierten Zahlungsarten. Danach sendet ePayco die Bestätigung an Ihren Shop und leitet den Kunden zurück. Die Bestellung wird erst als bezahlt markiert, wenn ePayco die Zahlung bestätigt hat: durch die signierte Bestätigung oder durch eine serverseitige Anfrage an ePayco, wenn der Kunde zurückkehrt. Die bloße Rückkehr des Kunden bezahlt nie eine Bestellung.
Wenn die Zahlung noch nicht bestätigt ist, zeigt die Seite „Bestellung eingegangen“ den Hinweis We are waiting for ePayco to confirm your payment. This page does not need to stay open. Bei einer ausstehenden Zahlung (zum Beispiel PSE oder Barzahlung) lautet der Hinweis Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved.
Wurde die Zahlung abgelehnt, kehrt der Kunde zur Seite Pay for order zurück, mit dem Hinweis Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. Kehrt der Kunde ohne Zahlung zurück, lautet der Hinweis The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again.
Kann ePayco die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel We could not connect to ePayco. Please try again in a moment or choose another payment method. Der Grund wird den Bestellnotizen und dem Protokoll hinzugefügt.
Die Zahlungsart funktioniert an der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit der High-Performance-Bestellspeicherung von WooCommerce (HPOS) kompatibel. Die für Kunden sichtbaren Texte sind auf Spanisch übersetzt.
Das Plugin unterstützt nur einmalige Zahlungen. Es gibt keine Erstattungen aus WooCommerce, keine gespeicherten Karten, Abonnements oder Split-Zahlungen, und es fragt bei ePayco keine ausstehenden Transaktionen ab: Bestellungen werden durch die ePayco-Bestätigung und die Rückkehr des Kunden aktualisiert.
Bestellungen
Bestellstatus
Pending payment: der Kunde wurde zu ePayco weitergeleitet und hat noch nicht bezahlt, oder ePayco hat die Zahlung noch nicht bestätigt.
Processing: die Zahlung wurde akzeptiert (Bestellungen mit nur virtuellen, herunterladbaren Produkten werden auf Abgeschlossen gesetzt, dem WooCommerce-Standard). Die Bestellnotiz zeigt die ePayco-Referenz, den Status, den Betrag, die Zahlungsart und den Genehmigungscode. Die Transaktions-ID der Bestellung ist die ePayco-Referenz (ref_payco).
On hold, payment pending: ePayco hat die Zahlung als ausstehend oder zurückgehalten gemeldet, zum Beispiel eine PSE-Überweisung oder eine Barzahlung. Die Bestellung ändert sich automatisch, wenn ePayco sie bestätigt oder ablehnt.
On hold, amount/currency mismatch: ePayco hat eine Zahlung genehmigt, deren Betrag oder Währung von der Bestellung abweicht. Versenden Sie nicht, bevor Sie die Transaktion im ePayco-Dashboard geprüft haben.
On hold, payment for a cancelled order: ePayco hat eine Zahlung genehmigt, nachdem die Bestellung storniert worden war. Stellen Sie die Bestellung wieder her oder erstatten Sie die Zahlung in ePayco.
Failed: die Zahlung wurde abgelehnt, ist fehlgeschlagen, abgelaufen, abgebrochen, storniert oder durch die Betrugsprüfung gestoppt worden. Die Notiz zeigt den Grund von ePayco. Der Kunde kann es erneut versuchen. Ein späterer Fehlschlag ändert nie eine bezahlte Bestellung.
Refunded: ePayco hat die Zahlung dieser Bestellung zurückerstattet.
Meldet ePayco eine weitere genehmigte Zahlung für eine bereits bezahlte Bestellung, ändert sich der Status nicht. Eine Notiz fordert Sie auf, eine Doppelbelastung zu prüfen und sie bei Bedarf in ePayco zu erstatten. Eine Testtransaktion für eine im Livemodus angelegte Bestellung sowie eine Transaktion, die bereits zu einer anderen Bestellung gehört, werden mit einer Notiz ignoriert.
Erstattungen: Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie die Zahlung im ePayco-Dashboard und erfassen Sie die Erstattung anschließend in WooCommerce mit Refund manually.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > ePayco. 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 funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Kontingent nicht frei. Geben Sie das Kontingent in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird ePayco Kunden an der Kasse nicht angezeigt. Wird trotzdem 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.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
ePayco wird an der Kasse nicht angezeigt: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, alle vier Schlüssel eingegeben sind und die Shopwährung COP oder USD ist. Auf der Seite Pay for order wird die Bestellwährung geprüft. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt.
Die Zahlung ging durch, aber die Bestellung bleibt Pending payment: Die ePayco-Bestätigung erreicht Ihren Shop nicht. Prüfen Sie, ob die in den Einstellungen angezeigte Bestätigungs-URL aus dem Internet erreichbar ist und nicht durch den Wartungsmodus, eine Firewall, ein Sicherheits-Plugin oder eine Basis-Authentifizierung blockiert wird. Aktivieren Sie Logging und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_epayco_payment. Die Bestellung wird auch aktualisiert, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.
Die Bestätigung meldet Invalid signature: Customer ID (P_CUST_ID_CLIENTE) oder Secret Key (P_KEY) passt nicht zu dem ePayco-Konto, das die Zahlung erhalten hat. Kopieren Sie beide erneut aus dem ePayco-Dashboard.
Die Bestätigung meldet Gateway not configured: P_CUST_ID_CLIENTE oder P_KEY ist leer. Tragen Sie die Werte in den Einstellungen ein.
Die Bestätigung meldet Busy, retry later: Die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert. ePayco wiederholt die Bestätigung.
Der Kunde sieht We could not connect to ePayco: ePayco hat PUBLIC_KEY und PRIVATE_KEY abgelehnt. Die Bestellnotiz zeigt die Antwort von ePayco. Kopieren Sie beide Schlüssel erneut.
Der Kunde sieht ePayco could not start the payment: ePayco hat die Checkout-Sitzung nicht erstellt. Lesen Sie die Bestellnotiz für den ePayco-Fehler.
Der ePayco-Checkout öffnet sich nicht: der Kunde sieht The ePayco checkout could not be loaded. Please reload the page or choose another payment method. Das ePayco-Checkout-Skript konnte auf der Zahlungsseite der Bestellung nicht geladen werden. Der Kunde kann die Seite neu laden oder Choose another payment method verwenden.
Eine Testzahlung hat die Bestellung nicht bezahlt: Testtransaktionen bezahlen niemals Bestellungen, die im Livemodus angelegt wurden. Legen Sie die Testbestellung an, während Test Mode eingeschaltet ist.
Bestellung ist On hold: lesen Sie die Bestellnotiz. ePayco hat die Zahlung als ausstehend gemeldet, der genehmigte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam, nachdem die Bestellung storniert worden war. Prüfen Sie die Transaktion im ePayco-Dashboard, bevor Sie versenden.
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 ein Kontingent 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 letzten bekannten Status weiter.
Für Entwickler listet die Plugin-Dokumentation die Filter epc_p_supported_currencies (Währungen, für die die Zahlungsart angeboten wird), epc_p_session_payload (an ePayco gesendete Daten) und epc_p_icon (Symbol am Checkout) auf.
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 Einstellungen des Gateways und die Logs werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte ePayco-Daten bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
ePayco ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit ePayco verbunden noch wird es von ePayco unterstützt.