Dokumentation Payone

Geändert am Mi, 22 Mai um 1:29 NACHMITTAGS


INHALTSVERZEICHNIS


1. Bitte beachten bei Plugin Updates


Die direkt bei den Zahlungsarten hinterlegten Einstellungen (vor Bestellabschluss / nach Bestellabschluss, Zahlungsarten Bild, Zahlungsarten Bezeichnung usw.) werden vom JTL Shop nach einem Update auf standard zurückgesetzt. Dies kann beim Plugin Update leider nicht verhindert werden.


Bitte überprüfe deshalb die Einstellung nach der Aktualisierung des Plugins und ändere diese, falls gewünscht.


WICHTIG: Bei der JTL-Shop Zahlungsart "Kreditkarte" müssen die Anzeigenamen z.B. in "XXX" geändert werden, da die WAWI sonst falsche Zuweisungen macht. (Grundsätzlich sollten keine Zahlungsarten doppelt zu finden sein, egal ob aktiv oder inaktiv)


2. Voraussetzungen


Voraussetzung für den Betrieb des Plugins sind gültige Zugangsdaten der Plattform  PAYONE.


Hierfür wird die sog. Server und Client API benötigt. Bitte vergewissere Dich sich vor der Anmeldungen, um welche API es sich bei Deinem Paket handelt und halte, wenn nötig, Rücksprache bei BS PAYONE.

Unter Punkt 9 findest Du eine Erklärung mancher Begrifflichkeiten zum besseren Verständnis.


3. Schnellkonfiguration des Plugin

Folge hierzu dem Einrichtungsassisten im Pluginbackend.


Erledigt, ab sofort können Deine Kunden mit den aktivierten BS PAYONE Zahlungsarten bezahlen.


4. Konfiguration im Detail


4.1. Deine Zugangsdaten


Wenn Du das Plugin frisch installierst und erstmals aufrufst, wirst Du gebeten Deine PAYONE Zugangsdaten im Plugin einzutragen.

Diese findest Du direkt im PAYONE Backend unter https://pmi.pay1.de/

Je nachdem, ob Du das Plugin über den Konfigurationsassistenten oder direkt über die Einstellungen pflegst, musst Du folgende Schritte durchführen:


4.1.1 Deine Merchant ID


Deine Merchant ID findest Du in Deinem PAYONE Account unter https://pmi.pay1.de/merchants/ . Du findest Deine ID unter Verwaltung -> Login.


Merchant-ID

4.1.2 Deine Portal-ID


Deine Portal ID des zu verwendenden Zahlungsportals findest Du unter https://pmi.pay1.de/merchants/ unter Konfiguration -> Zahlungsportale -> ID des Zahlungsportals Typ Shop


Portal-ID

4.1.3 SubAccount-ID


Die ID des zu verwendenden SubAccounts, zu finden bei https://pmi.pay1.de/merchants/ unter Konfiguration -> Accounts


Subaccount


Um Deine Produkte und Dienstleistungen über PAYONE abzurechnen, benötigst Du mindestens einen so genannten SubAccount (Unterkonto). Jede Transaktion wird einem solchen SubAccount zugeordnet.

In Kombination mit der PAYONE Pro Statistik hast Du auf diese Weise die Möglichkeit das Kaufverhalten Deiner Kunden und Deine Umsätze für jeden SubAccount separat zu betrachten.

Zudem hast Du die Möglichkeit beim Export der Buchungsdaten diese anhand der SubAccounts aufzuschlüsseln. Dies ist vor allem bei Marketingkampagnen ein komfortables Werkzeug, um den Erfolg jeder einzelnen Kampagne zu messen.

SubAccounts verwalten und neue SubAccounts anlegen kannst Du unter dem Punkt "Accounts".


4.2 Schlüssel


Schlüssel des zu verwendenden Zahlungsportals, zu finden bei BS PAYONE unter Konfiguration -> Zahlungsportale

Klicke dann beim Zahlungsportal Typ Shop auf [editieren], anschließend auf den Reiter [erweitert]. Der hier angezeigte Key ist Dein Schlüssel.


Key

4.3 Betriebsmodus


Hier hast Du die Wahl, ob das Plugin zunächst nur im Testbetrieb funtionieren soll ("TEST") oder ob Du die Zahlungsarten gleich live ("LIVE") schalten möchtest.


4.4 Firmenname


Zum Schluss gib bitte noch den Firmennamen exakt so ein, wie er bei BS PAYONE hinterlegt ist. Du findest diesen unter https://pmi.pay1.de/merchants/   Verwaltung -> Login


Firma


4.6 Autorisierung


Du kannst zwischen Autorisierung und Vorautorisierung auswählen.

In 99% der Fälle wählst Du Autorisierung (voreingestellt).

Bei der Autorisierung wird der zu zahlende Betrag sofort vom Konto des Kunden abgebucht (standard).


4.7 Vorautorisierung


Bei Zahlung über eine Vorautorisierung wird diese auf der Kreditkarte des Kunden "reserviert".

Du hast dann die Möglichkeit die Buchung manuell anzustoßen (capture). Dies erfolgt in Deinem Payone Merchant Center (http://pmi.pay1.de) oder im Dashboard des Plugins in Deinem Shop (siehe Punkt 5.1 Dashboard)

Verwende Vorautorisierung nur, falls Du weißt, was Du tust tun und dies ggf. mit PAYONE abgesprochen hast.


4.8 TransaktionsStatus URL konfigurieren


Die URL findest Du im Pluginbackend unter dem Reiter "Dashboard". 


Diese hinterlegst Du im PAYONE Merchant Interface unter: "Konfiguration > Zahlungsportale > Typ Shop > Erweitert > TransactionStatus URL":


dashboard

 

Sollte die URL im Plugin mit "http://" angezeigt werden, Du jedoch ein SSL Zertifikat haben, hinterlege die URL im PMI mit "https://".


Stelle hier das "Verfahren zur Hashwert-Prüfung" auf "md5 oder sha2-384 (für Migration)".

Ob die TransactionStatus URL erreichbar ist, kannst Du testen, indem Sie die URL im Browser öffnest: hier solltest Du dann ein "TSOK" sehen.


Die TransactionStatus URL folgt folgenden Schema.


https://meinShop.de/plugins/ws5_payone/transaction.php


4.9 Zugangsdaten pro Zahlungsart (BNPL-Zahlungsarten)


Damit du einige Zahlungsarten (darunter die BNPL-Zahlungsarten) nutzen kannst, musst du pro Zahlungsart individuelle Zugangsdaten im Plugin hinterlegen. 


Dies kannst du in der Zahlungsartenverwaltung im Shopbackend, direkt bei den Zahlungsarten selbst machen.



5. Das Plugin Backend Menü


5.1 Dashboard


Die Übersichtsseite des Plugin Backend. Hier hast du eine Übersicht über das ganze Plugin.


5.2 Verfügbare Bezahlmethoden


Hier finden sich alle verfügbaren Bezahlmethoden und Du kannst diese aktivieren und deaktivieren.

Bitte wähle nur Zahlungsarten aus, die von Dir für PAYONE aktiviert wurden.



5.3 Einstellungen


Hier triffst Du alle Einstellungen des Plugins, wie die Eingabe der Zugangsdaten, der Portal ID, des Modus (standardmäßig ist dieser auf TEST gestellt, d.h. alle Transaktionen sind als solche anzusehen) uvm.



6. Informationen zu den Zahlungarten


6.1 Allgemeines

 

Um die Zahlungsarten des Plugins zu nutzen, aktiviere diese bitte im Backend Deines JTL-Shops und weise die Zahlungsart einer Versandart zu.


6.2 Zahlart: Kreditkarte (3D Secure)


Standardmäßig ist die Kreditkartenzahlung über eine Autorisierung aktiv, d.h. die Zahlung wird direkt von der Kreditkarte des Kunden gebucht.

Weiteres zur Möglichkeit der Vorautorisierung, siehe Punkt 4.7


Mit dem Plugin bietest Du Ihren Kunden auch die Möglichkeit Zahlungen über dass 3D-Secure Verfahren abzuschließen.

Dieses Verfahren steht all Deinen Kunden automatisch zur Verfügung die mit ihrer Kreditkarte am sog. 3D-Secure Verfahren teilnehmen (de.wikipedia.org/wiki/3-D_Secure). 


6.3 Zahlart: PayPal


Die Bezahlung über PayPal wird über das vom Kunden bei PayPal hinterlegte Kreditkartenkonto/ EC-Konto abgewickelt und auf Dein PAYONE Konto gutgeschrieben.

Die Methode nennt sich bei PAYONE "Paypal Express", ist aber nicht zu verwechseln mit der Zahlungsart "PayPal Express".


Möchtest Du eine Zahlung über PayPal und dem Testmodus veranlassen, so informiere dich bitte direkt bei Paypal, da ein Geschäftkonto benötigt wird, welche über einen sogenannten Sandbox Benutzer verfügt.


6.4 Zahlart: Lastschrift


Die Zahlung wird über die Daten des Kontoinhabers abgewickelt. Im Testmodus sind Zahlungen mit der IBAN: DE 0012 3456 7825 9910 0003, der BIC: TESTTEST und dem Land "Deutschland" und einem beliebigen Namen durchführbar.


6.5 Payolution Zahlungsarten


Bitte beachte, dass alle Payolution Zahlungsarten immer per preauthorization durchgeführt werden (unanhängig der Einstellung). D.h. Du müsst alle Zahlungen mit Payolution manuell capturen.

Weitere Infos erhältst Du bei Deinem Payone Ansprechpartner


7. Anlage der Zahlungsart innerhalb der JTL WAWI


>> Anlage der Zahlungsart innerhalb der JTL WAWI


8. PAYONE Debitorenverwaltung


>> PAYONE Debitorenverwaltung


9. Begrifflichkeiten

  • Server API, Client API
  • Die Server und Client API sind Schnittstellen zur Initiierung von Zahlungsvorgängen und der Übermittlung von Daten an die PAYONE Plattform. Bitte achte bei der Zusammenstellung Deines Leistungspakets darauf, dass beide darin enthalten sind. Nur mit beiden lässt das PAYONE Plugin nutzen.
  • Vorautorisierung vs. Autorisierung
    Bei der Autorisierung wird der zu zahlende Betrag sofort vom Konto des Kunden abgebucht. Bei der Vorautorisierung wird der zu zahlende Betrag auf dem Konto des Kunden reserviert. Er kann dann später, wenn der Kunde die Ware erhalten hat, abgebucht werden (capture).
  • iFramed Hosted Lösung
    diese Lösung wird momentan von Payone eingesetzt. Damit wird sichergestellt dass Dein Shopsystem nicht in Kontakt mit den sensiblen Kreditkartendaten Deiner Kunden gerät. Ansonsten müsstes Du verschiedene Zertifizierungen durchlaufen und jährlich wiederholen.
  • Capturen
    Mit capture wird der Vorgang bezeichnet die Zahlung bei der Bank anzustoßen, also einzuziehen. Dies muss i.d.R. bei der Vorautorisierung manuell vom Shopbetreiber gemacht werden, damit das Geld ausbezahlt wird. Dies kann im Plugin Dashboard (Aktion) oder im PAYONE Backend erfolgen.

Tags: