| Table of Contents | ||||
|---|---|---|---|---|
|
...
Dieses Plugin integriert die Zahlungsart Arvato AfterPay Riverty in Ihren JTL-Shop. Die Arvato Payment Solutions Riverty GmbH ist ein international zugelassenes Zahlungsinstitut und erbringt PSD2-konforme Zahlungsdienste. AfterPay Riverty ermöglicht es Bestellungen über Rechnung, Lastschrift und Ratenzahlung zu bezahlen.
Die Begriffe Zahlungsart und Zahlungsmethode werden oft synonym verwendet. In diesem Kontext beschreibt der Begriff “Zahlungsart” AfterPay Riverty als einen Anbieter mehrerer möglicher Zahlungsmethoden, wie Rechnung, Lastschrift bzw. Ratenzahlung.
Features
Frontend:
Zahlungsart AfterPay Riverty Rechnung
Zahlungsart AfterPay Riverty Lastschrift
Zahlungsart AfterPay Riverty Ratenzahlung
Backend:
Übersicht und Suche von Bestellungen
übergeordnete Aktionen auf Zahlungen (Capture, Refund, Void)
Cross-Funktionale Aktionen zwischen JTL-WAWI und Shop (Capture, Void)
Konfigurationshilfe zum Plugin
...
Weitere Voraussetzungen
Sie benötigen ein AfterPay Riverty Händlerkonto. Bitte wenden Sie sich hierzu an AfterPayRiverty.
Beta-Tester registrieren sich auf der Sandbox und erstellen die länderspezifischen API-Keys unter dem Tab-Menüpunkt Credentials:
...
Das Plugin unterstützt Sie bei der Einrichtung der Zahlungsart, wählen Sie dafür den Reiter “Hilfe“ im AfterPay Riverty Plugin aus. Sie erhalten dort eine Übersicht über die Konfiguration zum Plugin. Überprüfen Sie and der Stelle die von Ihnen hinterlegten Einstellungen zu den Zahlungs- und Versandarten.
...
Die Konfiguration der Zahlungsart erfolgt über die Standard-Verwaltung im JTL-Shop. Sie finden die Zahlungsarten unter Administration → Zahlungsarten. Einen direkten Link dahin finden Sie auch auf der Hilfe-Seite des Plugins. Sie können hier alle drei Zahlungsmethoden von AfterPay Riverty einzeln konfigurieren.
Das Plugin implementiert die 2-Step-Authorisierung, d.h. die verfügbaren Zahlungsmethoden sind bereits vor dem Abschluss der Bestellung identifiziert. Eine “Zahlung nach Bestellabschluss” ist nicht möglich.
...
Neben den Standard-Einstellungen für Zahlungsarten finden sich im Plugin unter Einstellungen die übergeordneten Einstellungen zur Zahlungsart AfterPayRiverty.
Sie können hier Ihre Merchant-ID und den Capture-Modus einstellen,
Option | Bedeutung |
|---|---|
Merchant-ID | Tragen Sie hier Ihre Merchant-ID ein. Diese erhalten Sie von AfterPay Riverty zugewiesen. Sie wird verwendet um die AfterPayRiverty-seitigen Verlinkungen mit ihrer Geschäftsfirmierung zu personalisieren. |
Capture-Modus | Sie können zwischen zwei Modi beim Capture wählen, dabei wird immer ein Full-Capture durchgeführt. Diese Option kommt zum tragen, wenn der Versandstatus (Teilgeliefert/Verpackt und versendet) für eine Bestellung in der JTL-WAWI geändert wird. Capture beim ersten Teilversand bedeutet, dass sobald eine Teillieferung erfolgt, der ganze Rechnungsbetrag bezahlt wird. Capture bei Komplettversand hingegen bedeutet, dass der Rechnungsbetrag bezahlt wird, wenn die gesamte Bestellung versendet worden ist. |
...
Option | Bedeutung | Standard |
|---|---|---|
[DE] Deutschland | Aktivieren Sie hier AfterPay Riverty für Deutschland, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[DE] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
[AT] Österreich | Aktivieren Sie hier AfterPay Riverty für Österreich, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[AT] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
[CH] Schweiz | Aktivieren Sie hier AfterPay Riverty für die Schweiz, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[CH] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
[NO] Norwegen | Aktivieren Sie hier AfterPay Riverty für Norwegen, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[NO] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
[SE] Schweden | Aktivieren Sie hier AfterPay Riverty für Schweden, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[SE] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
[FI] Finnland | Aktivieren Sie hier AfterPay Riverty für Finnland, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[FI] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
[DK] Dänemark | Aktivieren Sie hier AfterPay Riverty für Dänemark, indem Sie diese in den Sandbox-, Partner- oder Live-Modus setzen. | nicht aktiv |
[DK] API-Key | Geben Sie hier den länderspezifischen API-Key ein. | - |
...
Diese Technologie wird eingesetzt, um die verwendeten Geräte (z. B. PCs, Smartphones, Tablets usw.) zu erkennen und zu identifizieren und um mögliche Betrugsversuche erkennen zu können. Sie können diese Lösung nutzen indem Sie sich bei AfterPay Riverty dafür freischalten lassen.
Option | Bedeutung |
|---|---|
Profile Tracking ID | Diese ID erhalten Sie von Ihrem AfterPay Riverty Ansprechpartner. Ohne diese ID ist die Funktion stets deaktiviert. |
Profile Tracking Modus | Stellen Sie hier den Betriebsmodus des Profile Trackings ein. Erforderlich beschreibt, dass der Kunde seine Zustimmung über eine eigene Checkbox geben muss. Optional beschreibt, dass er diese auslassen kann. Ansonsten erfolgt kein Tracking und es wird keine Checkbox angezeigt. |
Zusätzliche Datenschutz-URL (Profile Tracking) | Link für eine alternative Datenschutzrichtlinie für das Profile-Tracking. |
Wenn der Kunde durch Anklicken des Kontrollkästchens mit dem Datenschutz beim Profil-Tracking von AfterPay Riverty einverstanden ist, wird das Profil-Tracking-Skript auf der Bezahlseite geladen. Die Profile Tracking-Werte (profileTrackingId und IP-Adresse) werden dann an AfterPay Riverty übermittelt.
Erweiterte Einstellungen zu den Zahlungsarten
Ab Version 106 stehen Ihnen separate Einstellungen für die Aktivierung einzelner Zahlungsarten pro Land zur Verfügung. Sie können hiermit steuern welche Zahlungsarten im Shop angeboten werden unabhängig von den von AfterPay Riverty warenkorbbasierten Zahlungsarten. Die Zahlungsart Rechnung kann aktiviert werden sofern sie Ihre API-Zugangsdaten angegeben haben. Ist Rechnung aktiviert, dann können Sie auch Lastschrift oder Ratenzahlung aktivieren. Rechnung ist die Basis der Zahlungsarten und muss neben Lastschrift oder Ratenzahlung immer aktiv sein. Sie können Rechnung nur dann deaktivieren, wenn keine weiteren Zahlungsarten für dieses Land aktiv sind. Kurzum:
| Info |
|---|
AfterPay Riverty Rechnung kann nur für ein Land deaktiviert werden, wenn AfterPay Riverty Lastschrift und AfterPay Riverty Ratenzahlung für dieses Land deaktiviert ist! |
| Info |
|---|
AfterPay Riverty Lastschrift und AfterPay Riverty Ratenzahlung können nur für ein Land aktiviert werden, wenn AfterPay Riverty Rechnung für dieses Land aktiviert ist! |
Versandarten
Weisen Sie nun AfterPay Riverty den gewünschten Versandarten/Ländern unter Administration → Versand zu. Das Plugin berücksichtigt auch etwaige Aufschläge zur Zahlungsmethode. Einen direkten Link dahin finden Sie auch auf der Hilfe-Seite des Plugins.
JTL-Wawi
Damit die über AfterPay Riverty getätigten Bestellungen in der JTL-WAWI abgearbeitet werden können, sind hier weiterführende Einstellungen vorzunehmen. Die Bestellungen sind eingangs in der JTL-WAWI “nicht bezahlt” (Authorized) und müssen ohne Zahlungseingang versendet werden können.
...
Legen Sie als Zahlungsarten AfterPay Riverty Rechnung, AfterPay Riverty Lastschrift und AfterPay Riverty Ratenzahlung an. Beachten Sie, dass die Zahlungsarten dem “Angezeigten Namen“ im JTL-Shop entsprechen müssen. So auch gleichermaßen in Englisch Afterpay Riverty Invoice, Afterpay Riverty Direct Debit und Afterpay Riverty Fix installments.
Aktivieren Sie bei allen Zahlungsarten die Option “Auslieferung vor Zahlungseingang möglich“.
...
Betrieb
Shop
Frontend
Die Zahlungsart AfterPay Riverty steht Kunden nur unter gewissen Voraussetzungen zur Auswahl zur Verfügung.
...
| Info |
|---|
Befindet sich die Rechnungsadresse des Kunden in einem anderen Land, dann wird AfterPay Riverty als Zahlungsart nicht angeboten. |
...
| Info |
|---|
Ist das Rechnungsland nicht gleich dem Lieferland, dann wird AfterPay Riverty als Zahlungsart nicht angeboten. |
...
| Info |
|---|
Ist die Währung nicht die Währung des Rechnungslandes, dann wird AfterPay Riverty als Zahlungsart nicht angeboten. |
Der Gesamtbetrag der über AfterPay Riverty bezahlt werden kann ist auf 99.9 Millionen limitiert.
...
Der JTL-Shop arbeitet mit fest definierten Zahlungsarten. Diese sind auch für den reibungslosen Abgleich mit der JTL-WAWI notwendig. Allerdings können die auswählbaren AfterPay Riverty Zahlungsmethoden variieren, dies ist von internen Faktoren abhängig.
Initial sind alle drei Zahlungsmethoden im Shop verfügbar, sofern die o. g. Voraussetzungen erfüllt sind. Nachdem der Kunde eine Zahlungsmethode ausgewählt und die zusätzlich erforderlichen Felder ausgefüllt hat, wird eine Anfrage an AfterPay Riverty gesendet und die verfügbaren Zahlungsmethoden für den aktuellen Warenkorb zurückgegeben. Es erfolgt ein Abgleich, dabei werden nur die verfügbaren Zahlungsmethoden aktiviert. Ist z. B. ein Warenkorb-Betrag für Ratenzahlung zu gering, so wird Ratenzahlung nicht angeboten, bis sich der Warenkorb-Betrag vergrößert hat oder der Kauf abgeschlossen wurde. Im Fehlerfall wird eine entsprechende Meldung ausgegeben.
...
Im Plugin-Backend können Sie die Bestellungen einsehen, die mit AfterPay Riverty bezahlt wurden. Die Suche unterstützt Sie dabei die gewünschten Bestellungen zu finden.
Spalte | Bedeutung |
|---|---|
Bestell-Nr | Bestellnummer im Onlineshop |
Name | Vorname und Name des Kunden |
Zahlungsart | Die gewählte AfterPay Riverty Zahlungsmethode |
Status | Zahlungsstatus der Bestellung (Authorized, Captured, Redunded, Cancelled) |
Land | Rechnungsland der Bestellung |
Lieferung | Lieferland der Bestellung |
Betrag | Betrag der Reservierung (Authorize) |
Capture | Betrag der Zahlung (Capture) |
Storno | Summe der Rückzahlungen (Redund) |
Ablauf | Ablaufdatum der Autorisierung |
Aktionen | Anzeigen, Erstatten, Senden oder Invalidieren |
...
Ist der Status der Bestellung “Authorized“ (Reserved), dann wird dieser bei AfterPay Riverty storniert (Cancelled).
Ist die Bestellung allerdings schon “Captured“, “Refunded“ oder “Cancelled“, dann wird keine Aktion ausgeführt. Eine automatisierte Rückzahlung ist an der Stelle nicht vorgesehen, Sie können allerdings manuell über das Plugin-Backend eine (teilweise) Rückzahlung durchführen.
| Warning |
|---|
+++ ACHTUNG, WICHTIG +++Achten Sie bitte genaustens darauf, dass Sie in der JTL-WAWI nicht aus Versehen eine falsche Bestellung stornieren! Die JTL-WAWI bietet zwar die Möglichkeit eine Stornierung rückgängig zu machen, allerdings werden die von Ihnen durchgeführten Aktionen diesbezüglich 1:1 an den Onlineshop übertragen! In dem Fall würde zuerst die Bestellung storniert und die Zahlung gecancelt werden. Anschließend wäre die Bestellung zwar wieder reaktiviert aber eine Zahlung ist nicht mehr durchführbar! Sollten Sie im Anschluss die Ware versenden, dann erfolgt dies ohne Zahlungseingang! |
Begriffsklärung / Glossar
AfterPay Riverty betitelt seine Geschäftsprozesse analog zu den in der Kreditkartenwirtschaft, somit wird hier von einer
...
Die Gültigkeitsprüfung der Webseite validiert nur formal die Eingabe und prüft, ob das Geburtsdatum der SSN korrekt ist. Die inhaltliche Richtigkeit einer SSN wird von AfterPay Riverty festgestellt.
| Warning |
|---|
Die Währung, welche Sie angegeben haben ist für Ihr Rechnungsland nicht gültig. |
Dies ist der Fall, wenn der Kunde auf der Zusammenfassung-Seite versehentlich die Währungsanzeige verstellt hat. In diesem Fall wird er auf die Versand- und Zahlungsart-Seite zurückgeführt. Hier hat er die Möglichkeit entweder eine Zahlungsart passend zur gewünschten Währung auszuwählen oder die Währungsauswahl zu korrigieren. Dann wird AfterPay Riverty auch wieder als Zahlungsart angeboten.
...
Diese Meldung wird angezeigt, wenn die eingangs gewählte Zahlungsmethode (z.B. Ratenzahlung) durch die Pre-Autorisierung nicht bestätigt wird. Also diese nicht zu den angebotenen Zahlungsmethoden gehört. Dies kann der Fall sein, wenn Ratenzahlung mit einen viel zu niedrigen Warenkorbbetrag gewählt wurde oder eine Firma (USTID) Ratenzahlung auswählt. Aus technischen Gründen müssen initial alle AfterPay Riverty Zahlungsarten für den JTL-Shop angeboten werden.
| Warning |
|---|
AfterPay Riverty ist momentan nicht verfügbar. Bitte wählen Sie eine andere AfterPay Riverty Zahlmethode. |
Dieser Fehler tritt auf, wenn die Autorisierung nicht im Status “Accepted” endet. Tritt ein anderer Status auf wie z.B. “Pending“, dann kann keine Zahlung durchgeführt werden.
| Warning |
|---|
AfterPay Riverty ist nicht mehr verfügbar. Bitte wählen Sie eine andere Zahlart |
Tritt ein Fehler in der Kommunikation mit AfterPay Riverty auf, dann wird der Kunde auf die Zahlungsseite zurückgeführt und AfterPay Riverty nicht weiter als mögliche Zahlungsart für die aktuelle Session angeboten.
| Warning |
|---|
Der mit AfterPay Riverty zahlbare Gesamtbetrag ist überschritten. |
...
Im Plugin-Backend werden dem Händler zu jeder Aktion Erfolgs- und Fehlermeldungen angezeigt. Insbesondere werden Fehler in das Shop-Log geschrieben. Die Fehlermeldungen und die allgemeinen Kommunikation mit der AfterPay Riverty API kann dann bequem mit dem Präfix “Afterpay>“ “Riverty>“ gefiltert werden.
Um herauszufinden, wo ein Problem liegt, helfen Ihnen und uns die Logs. Je nach Fehlerbild ist eines der folgenden 3 Logs dafür mehr oder weniger relevant.
...
| Warning |
|---|
Achtung: Editieren Sie die Config-Datei des Shops nur, wenn Sie wissen, was Sie tun! Fehlerhafte Anpassungen hier können Ihren Shop unerreichbar oder (verschlüsselte) Daten unbrauchbar machen. Im Zweifelsfall sollten Sie Ihren Hoster oder Servicepartner um Hilfe fragen. |
Changelog
v1.1.0 (November 2022)
Rebranding Riverty
Erweiterung: Logging der API-Kommunikation in Shop-Log
v1.0.8 (Oktober2022Oktober 2022)
Keine Übertragung von Kundendaten bei der Ermittlung verfügbarer Zahlungsmethoden
...