Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:faqipayment

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
public:faqipayment [2017/10/25 16:14]
judithschmoeller
public:faqipayment [2024/04/03 14:48] (aktuell)
josefineleuschner [OXID Plugin - Ipayment Connector]
Zeile 1: Zeile 1:
-====== OXID Ipayment Connector ======+====== OXID Plugin - Ipayment Connector ======
  
-https://​www.fatchip.de/​Plugins/​OXID-eShop/​OXID-Ipayment-Connector.html+^ **Hinweis:​** | Wir haben den Vertrieb und die Entwicklung dieses Plugin eingestellt. \\ Sollten Sie eine gültige Lizenz besitzen und möchten mit einem Support-Anliegen an uns herantreten,​ dann nutzen Sie bitte unser [[https://​www.fatchip.de/​kontakt/​|Kontaktfomular]].| 
 + 
 +https://​www.fatchip.de/​Plugins/​OXID-eShop/​OXID-Ipayment-Connector.html ​\\ 
 +https://​github.com/​FATCHIP-GmbH/​plugin-oxid5-ipayment (private)
  
 ===== Requirements ===== ===== Requirements =====
  
 OXID CE/PE ab Version 4.6.x bis 4.10.x\\ OXID CE/PE ab Version 4.6.x bis 4.10.x\\
-OXID EE ab Version 4.6.x bis 5.3.x+OXID EE ab Version 4.6.x bis 5.3.x\\ 
 +\\ 
 +Der OXID Ipayment Connector wird aufgrund geringer Nachfrage leider __nicht__ für OXID 6 weiterentwickelt.
  
 ===== Installation ===== ===== Installation =====
  
-  -**Inhalt aus dem Ordner „copy_this“ kopieren** \\ In dem Modulpaket ​oxid2ipaymentPRO_oxid5_source befindet sich der Ordner //​copy_this//,​ kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen). \\ {{:​public:​ipay_1.1.png?​800|}} +  -**Inhalt aus dem Ordner „copy_this“ kopieren** \\ In dem Pluginpaket ​oxid2ipaymentPRO_oxid5_source befindet sich der Ordner //​copy_this//,​ kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops (bei FTP - binären Übertragungsmodus nutzen). \\ {{:​public:​ipay_1.1.png?​800|}} 
-  -**Install.sql ausführen** \\ Wechseln Sie im OXID Administrationsbereich zu //Service > Tools// und importieren Sie die //​install_pe.sql//​ (bei OXID CE/PE) oder die //​install_ee.sql//​ (bei OXID EE) Datei aus dem Modulpaket. Nachdem Sie die SQL Datei ausgewählt haben, klicken Sie auf „Update starten“, damit die Änderungen übernommen werden. \\ {{:​public:​ipay_1.2.png?​800|}}+  -**Install.sql ausführen** \\ Wechseln Sie im OXID Administrationsbereich zu //Service > Tools// und importieren Sie die //​install_pe.sql//​ (bei OXID CE/PE) oder die //​install_ee.sql//​ (bei OXID EE) Datei aus dem Pluginpaket. Nachdem Sie die SQL Datei ausgewählt haben, klicken Sie auf „Update starten“, damit die Änderungen übernommen werden. \\ {{:​public:​ipay_1.2.png?​800|}}
   -**Ipayment Connector aktivieren** \\ Aktivieren Sie den iPayment Connector im OXID Administrationsbereich unter //​Erweiterungen > Module > oxid2ipaymentPRO//​. \\ {{:​public:​ipay_1.3.png?​800|}}   -**Ipayment Connector aktivieren** \\ Aktivieren Sie den iPayment Connector im OXID Administrationsbereich unter //​Erweiterungen > Module > oxid2ipaymentPRO//​. \\ {{:​public:​ipay_1.3.png?​800|}}
   -**Weitere Informationen**\\ Sollte der OXID Ipayment Connector nach der Installation nicht wie erwartet funktionieren,​ prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind.\\ Weitere Informationen zu dem OXID Ipayment Connector finden Sie in unserem Online Shop unter https://​www.fatchip.de/​Plugins/​OXID-eShop/​OXID-Ipayment-Connector.html.\\ \\ Außerdem bietet FATCHIP einen Plugin-Installationsservice an. Weitere Informationen hierzu finden Sie unter\\ https://​www.fatchip.de/​Servicepakete/​Plugin-Installationsservice-OXID-eShop-PE.html oder\\ https://​www.fatchip.de/​Servicepakete/​Plugin-Installationsservice-OXID-eShop-EE.html.   -**Weitere Informationen**\\ Sollte der OXID Ipayment Connector nach der Installation nicht wie erwartet funktionieren,​ prüfen Sie ob alle Installationsschritte richtig durchgeführt worden sind.\\ Weitere Informationen zu dem OXID Ipayment Connector finden Sie in unserem Online Shop unter https://​www.fatchip.de/​Plugins/​OXID-eShop/​OXID-Ipayment-Connector.html.\\ \\ Außerdem bietet FATCHIP einen Plugin-Installationsservice an. Weitere Informationen hierzu finden Sie unter\\ https://​www.fatchip.de/​Servicepakete/​Plugin-Installationsservice-OXID-eShop-PE.html oder\\ https://​www.fatchip.de/​Servicepakete/​Plugin-Installationsservice-OXID-eShop-EE.html.
  
-==== Modul Update für OXID Versionen ab 4.7.0 ====+==== Plugin ​Update für OXID Versionen ab 4.7.0 ====
  
-  -**Inhalt aus dem Ordner „copy_this“ kopieren** \\ In dem Modulpaket ​oxid2ipaymentPRO_ oxid5_source befindet sich der Ordner //​copy_this//,​ kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops. Die alten Moduldateien ​werden dabei überschrieben (bei FTP - binären Übertragungsmodus nutzen). \\ {{:​public:​ipay_3.1.png?​800|}}+  -**Inhalt aus dem Ordner „copy_this“ kopieren** \\ In dem Pluginpaket ​oxid2ipaymentPRO_ oxid5_source befindet sich der Ordner //​copy_this//,​ kopieren Sie den Inhalt aus diesem Ordner in das Hauptverzeichnis Ihres OXID eShops. Die alten Plugindateien ​werden dabei überschrieben (bei FTP - binären Übertragungsmodus nutzen). \\ {{:​public:​ipay_3.1.png?​800|}}
   -**Ipayment Connector deaktivieren und aktivieren** \\ Nach der Updateinstallation müssen Sie den Ipayment Connector im OXID Administrationsbereich unter //​Erweiterungen > Module > oxid2ipaymentPRO > Stamm// einmal deaktivieren und danach wieder aktivieren. \\ {{:​public:​ipay_3.2.png?​800|}}   -**Ipayment Connector deaktivieren und aktivieren** \\ Nach der Updateinstallation müssen Sie den Ipayment Connector im OXID Administrationsbereich unter //​Erweiterungen > Module > oxid2ipaymentPRO > Stamm// einmal deaktivieren und danach wieder aktivieren. \\ {{:​public:​ipay_3.2.png?​800|}}
   -**Fehlende Template-Blöcke hinzufügen** \\ Wenn Sie nach der Updateinstallation zum ersten Mal die Ipayment Einstellungen unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen//​ aufrufen, werden Sie auf die fehlenden Template-Blöcke aufmerksam gemacht. Installieren Sie diese fehlenden Blöcke nach der angegebenen Reihenfolge über den „Hinzufügen“ Button. \\ {{:​public:​ipay_3.3.png?​800|}}   -**Fehlende Template-Blöcke hinzufügen** \\ Wenn Sie nach der Updateinstallation zum ersten Mal die Ipayment Einstellungen unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen//​ aufrufen, werden Sie auf die fehlenden Template-Blöcke aufmerksam gemacht. Installieren Sie diese fehlenden Blöcke nach der angegebenen Reihenfolge über den „Hinzufügen“ Button. \\ {{:​public:​ipay_3.3.png?​800|}}
Zeile 24: Zeile 29:
 ===== Configuration ===== ===== Configuration =====
  
-  -**Allgemeine Informationen** \\ Die Ipayment Connector Informationen können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Info// aufrufen. Hier finden Sie Informationen zu der verwendeten ​Modulversion ​und weiterführende Links. \\ {{:​public:​ipay_2.1.png?​800|}}+  -**Allgemeine Informationen** \\ Die Ipayment Connector Informationen können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Info// aufrufen. Hier finden Sie Informationen zu der verwendeten ​Pluginversion ​und weiterführende Links. \\ {{:​public:​ipay_2.1.png?​800|}}
   -**Fehlende Template-Blöcke hinzufügen & Temp Verzeichnis leeren** \\ Wenn Sie die Ipayment Einstellungen unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen//​ zum ersten Mal aufrufen, werden Sie auf die fehlenden Template-Blöcke aufmerksam gemacht und müssen diese hinzufügen. **Leeren Sie nach dem Hinzufügen der Template-Blöcke das Temp (tmp) Verzeichnis** in Ihrem OXID eShop Hauptverzeichnis. Die darin enthaltene **.htaccess-Datei darf** dabei aber **NICHT** gelöscht werden! \\ {{:​public:​ipay_2.2.png?​800|}}   -**Fehlende Template-Blöcke hinzufügen & Temp Verzeichnis leeren** \\ Wenn Sie die Ipayment Einstellungen unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen//​ zum ersten Mal aufrufen, werden Sie auf die fehlenden Template-Blöcke aufmerksam gemacht und müssen diese hinzufügen. **Leeren Sie nach dem Hinzufügen der Template-Blöcke das Temp (tmp) Verzeichnis** in Ihrem OXID eShop Hauptverzeichnis. Die darin enthaltene **.htaccess-Datei darf** dabei aber **NICHT** gelöscht werden! \\ {{:​public:​ipay_2.2.png?​800|}}
   -**Ipayment Connector Ipayment Einstellungen** \\ Nachdem die fehlenden Template-Blöcke hinzugefügt worden sind, können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen//​ die Ipayment Connector Einstellungen vornehmen. \\ {{:​public:​ipay_2.3.png?​800|}}   -**Ipayment Connector Ipayment Einstellungen** \\ Nachdem die fehlenden Template-Blöcke hinzugefügt worden sind, können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen//​ die Ipayment Connector Einstellungen vornehmen. \\ {{:​public:​ipay_2.3.png?​800|}}
Zeile 30: Zeile 35:
 |**Konfiguration**|**Beschreibung**| |**Konfiguration**|**Beschreibung**|
 |Ipayment aktiv|Ipayment Connector aktiv oder inaktiv setzen.| |Ipayment aktiv|Ipayment Connector aktiv oder inaktiv setzen.|
-|Supportkey|Den Supportkey finden Sie in der E-Mail mit Ihrem Modul. Ohne Nennung dieses Keys kann Ihnen die FATCHIP GmbH keinen Support leisten.|+|Supportkey|Den Supportkey finden Sie in der E-Mail mit Ihrem Plugin. Ohne Nennung dieses Keys kann Ihnen die FATCHIP GmbH keinen Support leisten.|
  
   4. **Ipayment Connector Verbindungseinstellungen** \\ Die Einstellungen zu den Ipayment Verbindungseinstellungen können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen > Verbindungseinstellungen//​ vornehmen. \\ {{:​public:​ipay_2.4.png?​800|}}   4. **Ipayment Connector Verbindungseinstellungen** \\ Die Einstellungen zu den Ipayment Verbindungseinstellungen können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Einstellungen > Verbindungseinstellungen//​ vornehmen. \\ {{:​public:​ipay_2.4.png?​800|}}
Zeile 61: Zeile 66:
 |SOAP-Exceptions protokollieren|Wenn Sie diese Option aktivieren, werden alle auftretenden SOAP-Exceptions inkl. Request und Response in die Datei log/​az_ipayment_soap_exceptions.log protokolliert.| |SOAP-Exceptions protokollieren|Wenn Sie diese Option aktivieren, werden alle auftretenden SOAP-Exceptions inkl. Request und Response in die Datei log/​az_ipayment_soap_exceptions.log protokolliert.|
  
-  8. **Ipayment Connector Protokoll einsehen** \\ Das Ipayment ​Connectro ​Protokoll können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Protokoll// einsehen. \\ {{:​public:​ipay_2.8.png?​800|}} \\ Protokoliert ​werden Zeitpunkt, Bestellnummer,​ Transaktions-ID,​ Zahlart, Kunden-E-Mail,​ Betrag, Situation, Fehlercode und Details. \\ Der Link zu der Fehlerliste für Kreditkartenzahlungen über ipayment-Terminalsystem wird ebenfalls bereitgestellt. \\ Ipayment Fehlercodes Kreditkartenzahlung:​ https://​ipayment.de/​technik/​errorlist.php?​pm_id=1&​language_id=0+  8. **Ipayment Connector Protokoll einsehen** \\ Das Ipayment ​Connector ​Protokoll können Sie unter //1&1 ipayment > oxid2ipaymentPRO > Protokoll// einsehen. \\ {{:​public:​ipay_2.8.png?​800|}} \\ Protokolliert ​werden Zeitpunkt, Bestellnummer,​ Transaktions-ID,​ Zahlart, Kunden-E-Mail,​ Betrag, Situation, Fehlercode und Details. \\ Der Link zu der Fehlerliste für Kreditkartenzahlungen über ipayment-Terminalsystem wird ebenfalls bereitgestellt. \\ Ipayment Fehlercodes Kreditkartenzahlung:​ https://​ipayment.de/​technik/​errorlist.php?​pm_id=1&​language_id=0
  
  
Zeile 67: Zeile 72:
  
   * [[#Welche OXID eShop Versionen sind mit dem iPayment Connector von FATCHIP kompatibel?​]]   * [[#Welche OXID eShop Versionen sind mit dem iPayment Connector von FATCHIP kompatibel?​]]
-  * [[#Erfüllt das Ipayment ​Modul die PCI DSS 3.0 Anforderungen?​]]+  * [[#Erfüllt das Ipayment ​Plugin ​die PCI DSS 3.0 Anforderungen?​]]
   * [[#​Best-Practice beim Debuggen]]   * [[#​Best-Practice beim Debuggen]]
   * [[#Ich bekomme einen Fehlercode von ipayment. Was sagt der Fehlercode aus?]]   * [[#Ich bekomme einen Fehlercode von ipayment. Was sagt der Fehlercode aus?]]
Zeile 87: Zeile 92:
  
  
-=== Erfüllt das iPayment ​Modul die PCI DSS 3.0 Anforderungen?​ ===+=== Erfüllt das iPayment ​Plugin ​die PCI DSS 3.0 Anforderungen?​ ===
  
 Mit der Version 2.4.0 des iPayment Connectors wurde die Option der Kreditkartendateneingabe über ein iFrame eingeführt. Somit erfüllt der iPayment Connector ab dieser Version die Anforderungen von PCI DSS 3.0. Mit der Version 2.4.0 des iPayment Connectors wurde die Option der Kreditkartendateneingabe über ein iFrame eingeführt. Somit erfüllt der iPayment Connector ab dieser Version die Anforderungen von PCI DSS 3.0.
Zeile 98: Zeile 103:
 === Best-Practice beim Debuggen === === Best-Practice beim Debuggen ===
  
-Das Modul greift nur dort ein, wo die entsprechende Zahlungsmethode verwendet wird. Dies ist jedoch nicht immer bei allen im Shop installierten ​Modulen ​der Fall. Oft gibt es unerwünschte Nebeneffekte dadurch, dass Module ​sich aneinander stören. Daher emfiehlt es sich andere im Shop installierte ​Module ​zeitweise auszuschalten um dann feststellen zu können, ob das oxid2ipaymentPRO-Modul nun wie gewünscht funktioniert. Hierbei empfiehlt es sich Modul für Modul durchzugehen und nicht alle auf einmal abzuschalten. Das widerum ist geeignet für den ersten Versuch, um generell auf Nebeneffekte anderer im Shop installierter ​Module ​zu prüfen.+Das Plugin ​greift nur dort ein, wo die entsprechende Zahlungsmethode verwendet wird. Dies ist jedoch nicht immer bei allen im Shop installierten ​Plugins ​der Fall. Oft gibt es unerwünschte Nebeneffekte dadurch, dass Plugins ​sich aneinander stören. Daher emfiehlt es sich andere im Shop installierte ​Plugins ​zeitweise auszuschalten um dann feststellen zu können, ob das oxid2ipaymentPRO-Plugin ​nun wie gewünscht funktioniert. Hierbei empfiehlt es sich Plugin ​für Plugin ​durchzugehen und nicht alle auf einmal abzuschalten. Das widerum ist geeignet für den ersten Versuch, um generell auf Nebeneffekte anderer im Shop installierter ​Plugins ​zu prüfen.
  
  
Zeile 124: Zeile 129:
 === Ich habe die PHP Dateien auf meinen Server hochgeladen. Die entsprechende Seite wird im Admin jedoch nicht angezeigt oder es gibt Fehlermeldungen === === Ich habe die PHP Dateien auf meinen Server hochgeladen. Die entsprechende Seite wird im Admin jedoch nicht angezeigt oder es gibt Fehlermeldungen ===
  
-Vermutlich haben Sie die Moduldateien ​im Textmodus hochgeladen. Beim oxid2ipaymentPRO-Modul ist es erforderlich die Dateien im sog. Binärmodus hochzuladen. Beim freien FTP-Programm [[http://​www.filezilla.de/​|Filezilla]] finden Sie diese Einstellung unter Transfer->​Transfertyp->​Binär+Vermutlich haben Sie die Plugindateien ​im Textmodus hochgeladen. Beim oxid2ipaymentPRO-Plugin ​ist es erforderlich die Dateien im sog. Binärmodus hochzuladen. Beim freien FTP-Programm [[http://​www.filezilla.de/​|Filezilla]] finden Sie diese Einstellung unter Transfer->​Transfertyp->​Binär
  
  
Zeile 132: Zeile 137:
 === Ich benutze die Shopversion CE/PE 4.7 oder EE 5. Wenn ich im Freitextfeld angebe, dass #ORDERNR# ausgegeben werden soll, passiert dies nicht. Wie kann ich die Bestellnummer anzeigen lassen? === === Ich benutze die Shopversion CE/PE 4.7 oder EE 5. Wenn ich im Freitextfeld angebe, dass #ORDERNR# ausgegeben werden soll, passiert dies nicht. Wie kann ich die Bestellnummer anzeigen lassen? ===
  
-Mit den neuen Oxid-Version CE/PE 4.7 bzw. EE 5 und höher hat sich der Moment, in dem die Bestell-Nr. in die Bestellung eingetragen wird, hinter den Moment der Bezahlung verschoben. Ab Modulverson ​2.2.3 haben wir diesen Moment wieder, wie in Oxid 4.6 und davor, in die Anlege-Routine der Bestellung umgesiedelt,​ welche vor der Bezahlung liegt. Dies sorgt dann dafür, dass die Bestell-Nr an der genannten Stelle wieder zur Verfügung steht.+Mit den neuen Oxid-Version CE/PE 4.7 bzw. EE 5 und höher hat sich der Moment, in dem die Bestell-Nr. in die Bestellung eingetragen wird, hinter den Moment der Bezahlung verschoben. Ab Pluginverson ​2.2.3 haben wir diesen Moment wieder, wie in Oxid 4.6 und davor, in die Anlege-Routine der Bestellung umgesiedelt,​ welche vor der Bezahlung liegt. Dies sorgt dann dafür, dass die Bestell-Nr an der genannten Stelle wieder zur Verfügung steht.
  
 Bitte beachten Sie, dass dies aber nur greift, wenn mit einer IPayment-Zahlart bezahlt wird. Bitte beachten Sie, dass dies aber nur greift, wenn mit einer IPayment-Zahlart bezahlt wird.
  
-Falls Sie eine Modulversion ​<2.2.3 in Verwendung haben, bitten wir Sie, sich bzgl. eines Updates mit uns in Verbindung zu setzen.+Falls Sie eine Pluginversion ​<2.2.3 in Verwendung haben, bitten wir Sie, sich bzgl. eines Updates mit uns in Verbindung zu setzen.
  
  
Zeile 158: Zeile 163:
 === Wir setzen die OXID Version 4.9.5 oder höher ein. Nach Eingabe der Kredikartendaten wird dem Kunden eine weiße Seite angezeigt. Was kann ich tun? === === Wir setzen die OXID Version 4.9.5 oder höher ein. Nach Eingabe der Kredikartendaten wird dem Kunden eine weiße Seite angezeigt. Was kann ich tun? ===
  
-Leider liegt eine Inkompatibilität zwischen unserem iPayment Connector und dem OXID PayPal ​Modul vor, welcher auf ein Problem im PayPal ​Modul zurückzuführen ist. Da wir keine Handhabe beim PayPal ​Modul haben, wurde von uns ein Workaround entwickelt. ​+Leider liegt eine Inkompatibilität zwischen unserem iPayment Connector und dem OXID PayPal ​Plugin ​vor, welcher auf ein Problem im PayPal ​Plugin ​zurückzuführen ist. Da wir keine Handhabe beim PayPal ​Plugin ​haben, wurde von uns ein Workaround entwickelt. ​
 Bitte aktualisieren Sie den iPayment Connector auf die Version 2.4.12 (oder höher). Bitte aktualisieren Sie den iPayment Connector auf die Version 2.4.12 (oder höher).
  
Zeile 179: Zeile 184:
 === Es gibt plötzlich Stornierungen und falsche Abbuchungen bei Bezahlungen über die internen Kreditkartenverarbeitung (nicht iFrame), wo könnte der Fehler liegen?​ === === Es gibt plötzlich Stornierungen und falsche Abbuchungen bei Bezahlungen über die internen Kreditkartenverarbeitung (nicht iFrame), wo könnte der Fehler liegen?​ ===
  
-ipayment hat einige Änderungen an der Antwortstruktur der XML von ipayment vorgenommen was diese Probleme verursachen kann. Nach einem Update auf die aktuelle ​Modulversion ​ab v2.5.0 sollte das Problem wieder behoben sein.+ipayment hat einige Änderungen an der Antwortstruktur der XML von ipayment vorgenommen was diese Probleme verursachen kann. Nach einem Update auf die aktuelle ​Pluginversion ​ab v2.5.0 sollte das Problem wieder behoben sein.
  
  
public/faqipayment.1508940879.txt.gz · Zuletzt geändert: 2017/10/25 16:14 von judithschmoeller