Benutzer-Werkzeuge
Inhaltsverzeichnis
Installations-und Konfigurationsanleitung für OXID 7
| Modul-Version | 1.2.2 – Stand 11.12.2025 |
| Modulname | Computop Payment Connector für den OXID eShop 7 |
| Modulkategorie | Bezahlmethoden / Payments Dieses Modul fügt dem OXID eShop zusätzliche Zahlungsarten hinzu. |
| Modulanbieter | COMPUTOP PAYGATE GMBH - Schwarzenbergstrasse 4 - 96050 Bamberg www.computop.com |
| Entwicklung des Moduls | Fatchip GmbH www.fatchip.de Mail: support@fatchip.de |
| Computop Merchant Support: | helpdesk@computop.com |
1. Funktionsübersicht
1.1 Funktionsbeschreibung
Das Computop Payment Plugin für OXID 7 ermöglicht die Anbindung von OXID 7 an die Computop Plattform.
Das Plugin unterstützt die Abwicklung nachfolgender Zahlungsarten:
Kredit- und Debitkarten inkl. 3D Secure
- Visa, MasterCard, American Express
Online-Überweisung
- iDeal (direkt oder via PPRO)
- Klarna
Lastschrift (SEPA)
- Ratepay
- SEPA-Lastschrift
- Klarna
Wallet
- Amazon Pay
- PayPal Standard
- PayPal Express
Ratenkauf
- easycredit
- Klarna
Rechnungskauf
- Ratepay
1.2 Systemvoraussetzungen und Hinweise
Für die Verwendung des OXID 7 Computop Payment Plugins sind folgende Systemvorrausetzungen notwendig:
- Installierter und lauffähiger OXID eShop ab Version 7.0
- Computop Händlerkonto und je nach verwendeten Zahlarten, Konten bei den Zahlungsanbietern wie Paypal, Klarna etc.
- PHP Version ab 8.0 bis 8.4
- Shop muss mit einem SSL-Zertifikat laufen und die https-Adresse muss in der Shop-Config hinterlegt sein
- Für automatische Zahlungsstatus-Updates muss der Shop extern erreichbar sein
- Der Server, auf dem das OXID 7 Computop Payment Plugin für den OXID eShop genutzt werden soll, muss selbstverständlich den OXID Server- und Systemvoraussetzungen entsprechen:
https://docs.oxid-esales.com/eshop/de/7.1/installation/neu-installation/server-und-systemvoraussetzungen.html
1.3 Erreichbarkeit des Shops von außen
Computop sendet zur Validierung von Transaktionen Requests an Ihren OXID eShop.
Damit solche Callback Aufrufe von Computop an Ihren Shop erfolgen können, muss Ihr Shop frei von draußen über das Internet erreichbar sein. Das heißt, es darf weder einen Passwortschutz, noch eine IP-Sperre oder einen Firewallschutz in Ihrem Shop aktiv sein, der Computop daran hindert, die entsprechenden Informationen an den Shop zu senden.
Denken Sie insbesondere daran, wenn Sie in Ihrer Entwicklungs- oder Stage-Umgebung testen wollen: HTTPS-Aufrufe von den externen Computop Servern auf Port 443 Ihres Servers müssen erlaubt sein.
2. Installation
Für die Installation des OXID 7 Computop Payment Plugins führen Sie die nachfolgenden Schritte aus:
- Loggen Sie sich auf die Kommandozeile (CLI) ein und navigieren Sie zum Rootverzeichnis des Shops
- Führen Sie folgenden Befehl aus:
composer require fatchip-gmbh/computop-payments-ox7
3. Update
ACHTUNG: breaking Changes bei Update von Release v1.1.0 oder älter auf Release v1.2.0 :
In dem Release v1.2.0 wurde die Konfiguration auf den Oxid-Standard umgezogen.
Sichern Sie vor einem Update Ihre Konfigurationseinstellungen und konfigurieren Sie das Modul nach erfolgreichem Update erneut.
Die aktuelle Versionsnummer des OXID 7 Computop Payment Plugin erhalten Sie unter https://github.com/FATCHIP-GmbH/plugin-oxid7-computop/releases
Für Plugin-Updates können Sie auch unseren Twitter-Account: https://twitter.com/fatchip folgen.
Um das OXID 7 Computop Payment Plugin zu aktualisieren, müssen Sie die nachfolgenden Schritte ausführen:
- Loggen Sie sich per sFTP/FTP auf Ihren Server ein und wechseln Sie in das Rootverzeichnis des Shops
- Öffnen Sie die composer.json und ändern Sie die angegebene Version auf die Version, auf die Sie aktualisieren möchten
- Loggen Sie sich auf die Kommandozeile (CLI) ein und navigieren Sie zum Rootverzeichnis des Shops
- Führen Sie den folgenden Befehl aus:
composer update
- Loggen Sie sich in den Admin Ihres OXID eShops ein
- Rufen Sie das Plugin unter Erweiterungen → Module auf
- Deaktivieren Sie das Plugin und Aktivieren Sie es wieder
4. Konfiguration
4.1 Allgemeine Angaben
Versandarten zuordnen
Ordnen Sie die neu erstellten Computop-Zahlungsarten unter „Shopeinstellungen“ → „Versandarten“ den entsprechenden Versandarten zu, so wie Sie es auch für andere Zahlungsarten im OXID eShop machen würden.
Computop Menü
Im eShop Admin Haupt-Menü taucht die neue Rubrik „Computop“ links mit mehreren Unter-Menüeinträgen auf:
4.2 General
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| MerchantID | Hinterlegen Sie hier Ihre MerchantID, die Sie von Computop erhalten haben. |
| MAC | Hinterlegen Sie hier en HMAC-Key, welchen Sie von Computop erhalten haben. |
| Passwort | Hinterlegen Sie hier Verschlüsselungspasswort, welches Sie von Computop erhalten haben. |
| Debug-Protokoll | Aktiviert die Protokollfunktion, damit sämtliche API-Kommunikation mit Computop aufgezeichnet wird. Dies kann bei der Analyse oder Fehlersuche nützlich sein. Im Produktiv-Betrieb sollte die Funktion abgeschaltet sein, da sich sonst ggf. große Log-Mengen anhäufen und sensitive Daten gespeichert werden. inactive: Das Aufzeichnen der API-Logs über den Standard hinaus, ist deaktiviert active: Das Aufzeichnen der API-Logs über den Standard hinaus, ist aktiviert extended: Dieses Log protokolliert sehr viele Daten und kann Last erzeugen. Diese Option sollte nur nach Rücksprache mit Computop oder Fatchip aktiviert werden! |
| Verschlüsselung | Hier stellen Sie die Verschlüsselungsmethode ein. Standard ist Blowfish. Sollte Ihr Server Blowfish nicht mehr unterstützen, wenden Sie sich bitte an den Computop Merchant Service, umn Ihr Merchant Konto auf AES umstellen zu lassen. Aktivieren Sie AES wirklich nur, nachdem die Umstellung auf AES erfolgt ist |
Ob die Zugangsdaten korrekt sind oder nicht, wird Ihnen nach dem Speichern angezeigt:
4.3 Kreditkarte
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| Kreditkarte - Modus | Hier legen Sie fest in welchen Schritten der Kunde seine Kreditkarten Informationen eingibt. IFRAME/PAYMENTPAGE: Kreditkartendaten werden nach Klick auf Zahlungspflichtig bestellen in einemn iFrame eingegeben. Silent Mode: Kreditkartendaten werden auf der Seite Bestellübersicht eingegeben. Hinweis: Für die Kreditkartenanbindung ist es notwendig eine PCI-Selbstauskunft für Ihren Kreditkarten Acquirer auszufüllen. Weitere Informationen erhalten Sie von Ihrem Computop Ansprechpartner. Bitte klären Sie vorab mit ihm, ob Sie die iFrame- oder die Silent Mode Variante nutzen wollen. |
| Kreditkarte - Testmodus | Das Plugin erlaubt den Betrieb der Kreditkartenzahlung in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt. |
| Kreditkarte - Visa (Silent Mode) | Hier legen Sie fest, ob Visa im Silent Mode zur Verfügung steht. |
| Kreditkarte - MasterCard (Silent Mode) | Hier legen Sie fest, ob Mastercard im Silent Mode zur Verfügung steht. |
| Kreditkarte - American Express (Silent Mode) | Hier legen Sie fest, ob American Express im Silent Mode zur Verfügung steht. |
| Kreditkarte - Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUAL: Geldeinzüge werden von Ihnen manuell im OXID Backend oder Computop Analytics durchgeführt. |
| Kreditkarte - Acquirer | Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Acquirer Sie verwenden. Diese Einstellung muss mit der Angabe auf Seiten von Computop übereinstimmen. |
| Kreditkarte - Template Name | Name der XSLT-Datei mit Ihrem individuellen Layout für das Bezahlformular. Wenn Sie kein individuelles Formular nutzen, verwenden Sie hier bitte den Templatenamen ct_responsive. |
4.4 iDeal
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| iDEAL - Dienst | iDEAL kann direkt oder über PPRO angebunden werden. Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Dienst Sie verwenden. |
4.5 PayPal
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| Paypal - Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell im OXID eShop Backend oder Computop Analytics durchgeführt. Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären. |
4.6 PayPal Express
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| PayPal Express - Test Modus | Das Plugin erlaubt den Betrieb von PayPal Express in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt. |
| PayPal Express - Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell im OXID eShop Backend oder Computop Analytics durchgeführt. Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären. |
| PayPal Express - Client-ID Option steht nur im Livemodus zur Verfügung | Tragen Sie hier Ihre PayPal-Express Client-ID ein. Weitere Informationen entnehmen Sie bitte der Developer Dokumentation |
| PayPal Express - Merchant-ID Option steht nur im Livemodus zur Verfügung | Tragen Sie hier Ihre PayPal-Express Merchant-ID ein. Weitere Informationen entnehmen Sie bitte der Developer Dokumentation |
| Computop - Partner-Attribution-ID Option steht nur im Livemodus zur Verfügung | Tragen Sie hier Ihre Computop Partner-Attribution-ID ein. Weitere Informationen entnehmen Sie bitte der Developer Dokumentation |
4.7 Lastschrift
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| Lastschrift - Capture Modus | Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird. AUTO: Reservierte Beträge werden sofort automatisch eingezogen. MANUELL: Geldeinzüge werden von Ihnen manuell im OXID eShop Backend oder Computop Analytics durchgeführt. Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären. |
4.8 Amazon Pay
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| AmazonPay - MerchantId | Geben Sie hier Ihre AmazonPay MerchantID ein. Weitere Informationen entnehmen Sie bitte der Developer Dokumentation |
| AmazonPay - Public Key Id | Geben Sie hier Ihre AmazonPay Public Key ID ein. Weitere Informationen entnehmen Sie bitte der Developer Dokumentation |
| Amazon Modus | Das Plugin erlaubt den Betrieb von Amazon Pay in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt. |
| Amazon Capture Modu | Tragen Sie hier Ihre Computop Partner-Attribution-ID ein. Weitere Informationen entnehmen Sie bitte der Developer Dokumentation |
| AmazonPay - Button Farbe | Hier können Sie die Farbe des AmazonPay-Buttons, welcher im letzten Schritt der Bestellung angezeigt wird, auswählen. Zur Auswahl stehen: - Gold - LightGray |
4.9 Klarna
Bis Version 1.1.0
ab Version 1.2.0
| Konfiguration | Beschreibung |
|---|---|
| Klarna Konto | Geben Sie hier das zu benutzende Klarna-Konto ein. Sollten Sie die Klarna-Integration testen wollen, geben Sie hier bitte test ein. |
4.10 Ratepay Lastschrift
ab Version 1.2.2 verfügbar
| Konfiguration | Beschreibung |
|---|---|
| BIC abfragen | Hier legen Sie fest, ob bei der Zahlung mit Ratepay Lastschrift eine BIC vom Kunden eingetragen werden muss. Dies hat vor allem bei internationaler Kundschaft Relevanz |
Zahlungsarten aktivieren
Aktivieren Sie die neu erstellten Computop-Zahlungsarten unter „Shopeinstellungen“ → „Zahlungsarten“ indem Sie die entsprechende Zahlungsart auswählen und die „Aktiv“-Checkbox setzten.
Versandarten zuordnen
Ordnen Sie die neu erstellten Computop-Zahlungsarten unter „Shopeinstellungen“ → „Versandarten“ den entsprechenden Versandarten zu, so wie Sie es auch für andere Zahlungsarten im OXID eShop machen würden.
5. API Logs
Im OXID eShop Adminbereich unter Computop → API finden Sie alle Logeinträge zu den Requests, Responses und Notifies.
6. Support
Sollten Sie Fragen zum Plugin und zu Ihrem Merchantkonto haben, wenden Sie sich bitte an den Computop Helpdesk helpdesk@computop.com.
Seiten-Werkzeuge
