... | ... | @@ -22,10 +22,55 @@ Bevor es mit der Installation und Konfiguration des CrefoPay Payment Plugin los |
|
|
|
|
|
Die CrefoPayment GmbH & Co. KG als Herausgeber der Software übernimmt keinerlei Haftung für etwaige Schäden, die durch die Verwendung des CrefoPay Payment Plugin entstehen. Um vor der Inbetriebnahme im Produktivbetrieb ausfühliche Funktions-Tests durchfüren zu können, kann beim CrefoPay Service Team unter [service@crefopay.de](mailto:service@crefopay.de) ein Zugang zur CrefoPay [Sandbox](https://sandbox.crefopay.de) angefragt werden.
|
|
|
|
|
|
### 2 Backup
|
|
|
### 1.3 Backup
|
|
|
|
|
|
Das CrefoPay Payment Plugin ist ausführlich getestet und von der Qualitätssicherung der CrefoPayment GmbH & Co. KG geprüft und freigegeben worden. Dennoch kann es bei jeder Software unter ungüstigen Umständen zu unerwarteten Fehlern bei der Installation bzw. der Inbetriebnahme kommen. Aus diesem Grund wird *dringend* dazu geraten eine Systemsicherung (Backup) zu erstellen, bevor die Software installiert und in Betrieb genommen wird.
|
|
|
|
|
|
## 2. CrefoPay Shop-Konfiguration
|
|
|
|
|
|
Das CrefoPay Service Team wird die Shop-Konfiguration in der Regel vorbereiten und anhand der bekannten URL für Test- bzw. Liveshop konfigurieren. Häufig kann es dennoch notwendig sein, die Konfiguration eigenständig anzupassen.
|
|
|
|
|
|
Dies kann direkt über den CrefoPay Händler Service Bereich erledigt werden. Die Folgenden Konfigurationspunkte sind wichtig, um einen reibungslosen Betrieb der CrefoPay Lösung zu gewährleisten.
|
|
|
|
|
|
### 2.1 Domäne
|
|
|
|
|
|
Für die sichere und PCI-DSS zertifizierte Frontend-Kommunikation verwendet das CrefoPay Plugin eine JavaScript Bibliothek. Damit diese störungsfrei die notwendigen Ressourcen einbinden und mit diesen kommunizieren kann, muss unter `Einstellungen > Hosted Fields Konfiguration > Domäne` die Domäne des (Test-) Shops bekannt gemacht werden:
|
|
|
|
|
|
![grafik](uploads/04df4a05a20bb8f76b6e7e61e0960eb5/grafik.png)
|
|
|
|
|
|
### 2.2 Success- und Failure- URL
|
|
|
|
|
|
Die Success- und Failure- URL sind für die Abwicklung von Umleitungszahlarten wichtig. Umleitungszahlarten sind Bezahlarten, bei denen eine externe Umleitung zur Autorisierung der Zahlung notwendig ist; beispielsweise die 2-Faktor-Authentifizierung nach dem 3D Secure Verfahren der Kreditkarte.
|
|
|
|
|
|
![grafik](uploads/490246fa1a49a3f65d0fbeb9827deb1a/grafik.png)
|
|
|
|
|
|
Damit der Kunde nach einer erfolgreichen Zahlung erfolgreich auf die Bestellabschlussseite - oder im Fehlerfall zur Zahlungsauswahl - umgeleitet wird, müssen die korrekten Umleitungs-Adressen in der Konfiguration hinterlegt sein. Diese können unter `Einstellungen > Shop Details > URL Konfiguration` festgelegt werden:
|
|
|
|
|
|
![grafik](uploads/40e767bc0b840923c36ddd9535f7bf0a/grafik.png)
|
|
|
|
|
|
#### 2.2.1 Success-URL
|
|
|
|
|
|
```https://www.mydomain.com/index.php?cl=thankyou&fnc=callback&result=success&orderID=-ORDERID-```
|
|
|
|
|
|
#### 2.2.2 Failure-URL
|
|
|
|
|
|
```https://www.mydomain.com/index.php?cl=payment&fnc=failure&orderID=-ORDERID-```
|
|
|
|
|
|
### 2.3 Benachrichtigungssystem
|
|
|
|
|
|
Die letzte wichtige URL wird unter `Einstellungen > Benachrichtigungssystem > Systembenachrichtigungen` definiert. Über das Benachrichtigungssystem werden die asynchronen Zahlungsbenachrichtigungen des CrefoPay Systems, an den (Test-) Shop gesendet. Außerdem läuft über die Statusbenachrichtigungen der Acknowledge-Handshake zwischen CrefoPay und dem Shopsystem ab. Das bedeutet, dass ein erfolgreicher Abschluss von CrefoPay Zahlungen nur mit einem korrekt eingerichteten Benachrichtigungssystem erfolgen kann.
|
|
|
|
|
|
**Bemerkungen:**
|
|
|
|
|
|
1. Einen falsch konfigurierten Benachrichtungsdienst erkennen Sie daran, dass alle CrefoPay Transaktionen im Status `AcknowledgePending` hängen bleiben.
|
|
|
2. Für den Betrieb des Oxid Plugins wird ausschließlich die `Statusbenachrichtigungsziel-URL` benötigt. Die `Zahlungsbenachrichtigungsziel-URL` wird hingegen nicht benötigt.
|
|
|
|
|
|
![grafik](uploads/9cfbc22561a20b8b782779a6c5b34f2e/grafik.png)
|
|
|
|
|
|
### 2.3.1 Statusbenachrichtigungsziel-URL
|
|
|
|
|
|
```https://www.mydomain.com/index.php?cl=crefopay_internal&fnc=notify```
|
|
|
|
|
|
Das CrefoPay Payment Plugin ist ausführlich getestet und von der Qaulitätssicherung der CrefoPayment GmbH & Co. KG geprüft und freigegeben worden. Dennoch kann es bei jeder Software unter ungüstigen Umständen zu unerwarteten Fehlern bei der Installation bzw. der Inbetriebnahme kommen. Aus diesem Grund wird *dringend* dazu geraten eine Systemsicherung (Backup) zu erstellen, bevor die Software installiert und in Betrieb genommen wird.
|
|
|
|
|
|
## 3. Installation
|
|
|
|
|
|
Das CrefoPay Payment Plugin wird als composer-Paket via packagist.org bereitgestellt und wird über composer installiert:
|
... | ... | |