VibeFox ePayco 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.

Währung: Kolumbianischer Peso (COP) oder US-Dollar (USD). Bei Warenkörben in anderen Währungen wird die Zahlungsart im Checkout 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 der Kunde nutzen kann (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 eine Firewall oder eine Basisauthentifizierung blockiert werden.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel funktioniert auf einer 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.

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

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

4. Geben Sie die vier ePayco-Schlüssel ein und wählen Sie den Checkout-Typ (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit eingeschaltetem Test Mode und ePayco-Testkarten, und schalten Sie danach Test Mode wieder aus.

Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting ePayco payment und ePayco payment on hold. PrestaShop stellt eine neue Zahlungsart für alle Währungen, Länder und Kundengruppen bereit. Sie können sie unter Payment > Preferences einschränken.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox ePayco Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder warnt die Seite, wenn nicht alle vier Schlüssel eingegeben sind (die Zahlungsart wird dann im Checkout ausgeblendet) und wenn die Standardwährung Ihres Shops weder COP noch USD ist. Bei aktiviertem Testmodus zeigt sie außerdem Test mode is on: customers pay with ePayco test cards and no real money is charged. an.

ePayco

Enable/Disable: Enable ePayco Payment schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden im Checkout sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: ePayco.

Description: der Text, der im Checkout unter der Zahlungsart angezeigt wird. Standard: Pay securely with ePayco.

Kontoschlüssel von ePayco

Die vier Schlüssel finden Sie im ePayco-Dashboard unter Integrations, API keys. P_CUST_ID_CLIENTE und P_KEY prüfen 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 dazu, die Signatur der ePayco-Zahlungsbestätigungen zu prüfen. Halten Sie ihn geheim.

Public Key (PUBLIC_KEY): Ihr öffentlicher ePayco-API-Schlüssel.

Private Key (PRIVATE_KEY): Ihr privater ePayco-API-Schlüssel. Halten Sie ihn geheim.

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

Gespeicherte geheime Schlüssel löschen: Setzen Sie einen Haken bei Secret Key (P_KEY) oder Private Key (PRIVATE_KEY) und klicken Sie auf Save, um den Schlüssel zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Test Mode: Checkout-Sitzungen werden als Testtransaktionen erstellt. Kunden bezahlen mit ePayco-Testkarten, und es wird kein echtes Geld abgebucht. Testtransaktionen bezahlen niemals Bestellungen, die im Livemodus angelegt wurden. Standard: aus. Solange er aktiv ist, sehen Kunden unter der Zahlungsart und auf der Zahlungsseite TEST MODE — use ePayco test cards, no real money is charged.

Checkout

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, im ePayco-Dashboard muss also nichts eingerichtet werden. Der Abschnitt zeigt die URL. Bei freundlichen URLs sieht sie so aus: https://your-shop/module/wcp_epayco_payment/confirmation, eventuell mit einem Sprachcode wie /en/. Sie muss aus dem Internet erreichbar sein und darf nicht durch eine Firewall oder Basisauthentifizierung blockiert werden. Sie funktioniert auch im Wartungsmodus des Shops und wird nicht durch die Ländereinschränkung Ihres Shops blockiert.

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 nichts. Ohne die Bestätigung wird eine Bestellung nur angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Erweitert

Logging: schreibt API-Fehler und Zahlungsbestätigungen in logs/epc_p_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus. Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist.

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: Wenn aktiviert, entfernt das Deinstallieren des Moduls die Modul-Einstellungen und das Protokoll. Die für Bestellungen gespeicherten ePayco-Daten und die Bestellstatus des Moduls bleiben immer erhalten, damit bestehende Bestellungen weiter funktionieren. Standard: aus.

Checkout

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig ePayco) und bestätigt. Das Modul erstellt eine ePayco-Checkout-Sitzung für den Warenkorbbetrag in der Warenkorbwährung, mit Steuern, Warenkorbnummer sowie Name, Adresse, E-Mail und Telefonnummer des Rechnungsempfängers. Bei ePayco erscheint die Zahlung als Cart # und die Warenkorbnummer. Die Checkout-Sprache ist Spanisch oder Englisch, je nach Shop-Sprache. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Anschließend sieht der Kunde die Seite ePayco payment mit Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. 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. Jeder Klick auf die Zahlungsschaltfläche erstellt eine neue ePayco-Sitzung.

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: durch die signierte Bestätigung oder durch eine serverseitige Anfrage bei ePayco, wenn der Kunde zurückkehrt. Die Rückkehr des Kunden allein bezahlt niemals eine Bestellung. Danach wird die Bestellung angelegt und der Kunde sieht die übliche Bestellbestätigungsseite.

Bei einer ausstehenden Zahlung (zum Beispiel PSE oder Barzahlung) wird die Bestellung in Awaiting ePayco payment angelegt, und die Bestätigungsseite zeigt Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved. Wird die ausstehende Zahlung später abgelehnt oder läuft sie ab, zeigt die Seite Your ePayco payment was not completed. Please contact us about this order. Hat ePayco die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, erscheint eine Seite Payment confirmation mit We are waiting for ePayco to confirm your payment. This page does not need to stay open. und einer Schaltfläche Check again.

Wurde die Zahlung abgelehnt, kehrt der Kunde zum Checkout zurück, mit 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 die Meldung 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. Der Warenkorb bleibt erhalten, und es wird keine Bestellung angelegt.

Kann ePayco die Zahlung nicht starten, bleibt der Kunde im Checkout mit einer kurzen Meldung, zum Beispiel We could not connect to ePayco. Please try again in a moment or choose another payment method. Der technische Grund wird im Protokoll festgehalten.

Das Modul unterstützt nur einmalige Zahlungen. Es gibt keine Erstattungen aus dem Shop, keine gespeicherten Karten, Abonnements oder Split-Zahlungen, und ausstehende Transaktionen werden nicht bei ePayco abgefragt: Bestellungen werden durch die ePayco-Bestätigung und die Rückkehr des Kunden aktualisiert.

Bestellungen

Bestellstatus

No order yet: Der Kunde wurde zu ePayco weitergeleitet und hat noch nicht bezahlt, ePayco hat die Zahlung noch nicht bestätigt, oder die Zahlung wurde abgelehnt. Es existiert nur der Warenkorb.

Payment accepted: ePayco hat die Zahlung genehmigt. Die Zahlung wird mit der ePayco-Referenz (ref_payco) als Transaktions-ID erfasst, und eine Notiz zeigt Referenz, Status, Betrag, Zahlungsart und Genehmigungscode.

Awaiting ePayco payment: 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 die Zahlung genehmigt oder ablehnt.

ePayco payment on hold: ePayco hat eine Zahlung genehmigt, deren Betrag oder Währung von der Bestellung abweicht (zum Beispiel wurde der Warenkorb geändert, nachdem die Zahlung begonnen hatte), oder eine Zahlung nach der Stornierung der Bestellung genehmigt. Der tatsächlich gezahlte Betrag wird bei übereinstimmender Währung in der Bestellung erfasst. Versenden Sie nicht, bevor Sie die Transaktion im ePayco-Dashboard geprüft haben.

Payment error: Eine ausstehende Zahlung wurde abgelehnt, ist fehlgeschlagen, abgelaufen oder storniert. Die Notiz zeigt den Grund von ePayco. Eine neue genehmigte Zahlung für den Warenkorb bezahlt die Bestellung weiterhin. Ein später Fehlschlag ändert nie eine bezahlte Bestellung.

Refunded: ePayco hat die Zahlung dieser Bestellung rückgängig gemacht.

Meldet ePayco eine weitere genehmigte Zahlung für eine bereits bezahlte Bestellung, bleibt der Status unverändert. Eine Notiz fordert Sie auf, auf eine doppelte Belastung zu prüfen und diese 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.

ePayco-Zahlungsblock

Die Bestellseite zeigt einen Block ePayco payment mit der ePayco-Referenz (ref_payco), der Transaktions-ID, dem Status, der Zahlungsart, dem Genehmigungscode, dem Transaktionsdatum, einem Abzeichen Test mode für Testzahlungen und den ePayco notes der Bestellung. Bei einer Bestellung in ePayco payment on hold zeigt der Block eine Warnung, die Transaktion vor dem Versand zu prüfen.

Erstattungen

Erstattungen aus dem Shop werden nicht unterstützt. Erstatten Sie die Zahlung im ePayco-Dashboard und aktualisieren Sie die Bestellung bei Bedarf manuell in PrestaShop. Ein von ePayco gemeldeter Storno der Zahlungstransaktion setzt die Bestellung auf Refunded.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox ePayco Payment ist der erste Block auf Modules > Module Manager > VibeFox ePayco 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 maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-payment-epayco 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. Nachdem sich die Adresse des Shops geändert hat oder Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einer Multistore-Einrichtung. Wenn Sie den Schlüssel aus dem Shop entfernen, wird sein Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird ePayco Kunden im Checkout 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 Zahlungsart 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 der Registerkarte 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 aber eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

ePayco erscheint nicht im Checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, alle vier Schlüssel eingegeben sind und die Warenkorbwährung COP oder USD ist. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: 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 eine Firewall, ein Sicherheitsmodul oder eine Basisauthentifizierung blockiert wird. Sehen Sie im Feld Log auf der Modulseite nach; aktivieren Sie Logging, um jede Bestätigung zu sehen. Die Bestellung wird auch angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestätigung antwortet «Invalid signature»: Customer ID (P_CUST_ID_CLIENTE) oder Secret Key (P_KEY) stimmt nicht mit dem ePayco-Konto überein, über das die Zahlung eingegangen ist. Kopieren Sie beide erneut aus dem ePayco-Dashboard.

Bestätigung antwortet «Gateway not configured»: P_CUST_ID_CLIENTE oder P_KEY ist leer. Tragen Sie sie in den Einstellungen ein.

Bestätigung antwortet «Order not found»: Die Bestätigung bezieht sich auf einen Warenkorb ohne ePayco-Zahlung dieses Shops.

Bestätigung antwortet «Busy, retry later»: Die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert, oder sie konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). ePayco wiederholt die Bestätigung. Der Grund steht im Protokoll.

Der Kunde sieht «We could not connect to ePayco»: ePayco hat PUBLIC_KEY und PRIVATE_KEY abgelehnt. Das Protokoll 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 den ePayco-Fehler im Protokoll.

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 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 im Status ePayco payment on hold: Lesen Sie die Notizen im Block ePayco payment (siehe Bestellstatus) und prüfen Sie die Transaktion im ePayco-Dashboard, bevor Sie versenden.

Deinstallation

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

ePayco ist eine Marke ihres jeweiligen Inhabers. Dieses Modul steht in keiner Verbindung zu ePayco und wird nicht von ePayco unterstützt.