Einleitung

Dieses Plugin integriert die Zahlungsart Riverty in Ihren JTL-Shop. Die Riverty GmbH ist ein international zugelassenes Zahlungsinstitut und erbringt PSD2-konforme Zahlungsdienste. 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” Riverty als einen Anbieter mehrerer möglicher Zahlungsmethoden, wie Rechnung, Lastschrift bzw. Ratenzahlung.

Features

Frontend:

• Zahlungsart Riverty Rechnung

• Zahlungsart Riverty Lastschrift

• Zahlungsart 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

Installation / Update

Systemvoraussetzungen

• JTL-Shop 5.00+ und dessen Voraussetzungen

Weitere Voraussetzungen

Sie benötigen ein Riverty Händlerkonto. Bitte wenden Sie sich hierzu an Riverty.

Beta-Tester registrieren sich auf der Sandbox und erstellen die länderspezifischen API-Keys unter dem Tab-Menüpunkt Credentials:

...

Plugin-Installation

Die Installation des Plugins erfolgt nach JTL-Standard, wie es hier beschrieben ist oder sie können Ihre vorhandene ZIP-Datei des Plugins auch über den Reiter “Upload“ in der Pluginverwaltung bereitstellen und anschließend im Reiter “Vorhanden“ die Installation starten.

Plugin-Update

Bei einem Update auf eine neuere Version können Sie der allgemeinen Installation folgen mit dem Unterschied, dass Sie direkt in der Pluginverwaltung den Update-Button zur Aktualisierung betätigen müssen.

Konfiguration

Shop

Das Plugin unterstützt Sie bei der Einrichtung der Zahlungsart, wählen Sie dafür den Reiter “Hilfe“ im 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.

Zahlungsarten

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 Riverty einzeln konfigurieren.

...

Profile Tracking

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 Riverty dafür freischalten lassen.

...

Wenn der Kunde durch Anklicken des Kontrollkästchens mit dem Datenschutz beim Profil-Tracking von Riverty einverstanden ist, wird das Profil-Tracking-Skript auf der Bezahlseite geladen. Die Profile Tracking-Werte (profileTrackingId und IP-Adresse) werden dann an 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 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:

...

Versandarten

Weisen Sie nun 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 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.

Zahlungsart einrichten

Öffnen Sie in der JTL-WAWI die Zahlungsartenverwaltung über Zahlungen → Zahlungsarten.

...

Aktivieren Sie bei allen Zahlungsarten die Option “Auslieferung vor Zahlungseingang möglich“.

Betrieb

Shop

Frontend

Die Zahlungsart Riverty steht Kunden nur unter gewissen Voraussetzungen zur Auswahl zur Verfügung.

...

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 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.

Backend

Im Plugin-Backend können Sie die Bestellungen einsehen, die mit Riverty bezahlt wurden. Die Suche unterstützt Sie dabei die gewünschten Bestellungen zu finden.

Aktionen

Anzeigen - Klicken Sie auf das Auge-Symbol, um die Details der Bestellung anzuzeigen. Neben den Bestelldaten und Zahlungsinformationen werden hier auch die Rückzahlungen aufgelistet.

...

Wawi

Eingehende Bestellungen und getätigte Zahlungen werden von der JTL-WAWI durch den Onlineshop-Abgleich eingelesen und verarbeitet (siehe Zahlungsart einrichten).

...

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.

Begriffsklärung / Glossar

Riverty betitelt seine Geschäftsprozesse analog zu den in der Kreditkartenwirtschaft, somit wird hier von einer

...

gesprochen. Diese Begriffe finden sich teilweise im Adminbereich wieder.

Individualisierung

Die Zahlungsart wird in der Standardauswahl der Zahlungsarten im JTL-Shop eingeblendet und hat keine individualisierbaren Elemente.

Troubleshooting

Sollten Sie Probleme mit dem Plugin beobachten, prüfen Sie zunächst die Logs und wenden Sie sich ggf. an unseren Support oder Ihren Service-Partner, wenn Sie das Problem nicht selbständig lösen können.

Je mehr Informationen Sie dem Support bei einem Problem geben können, desto eher sind wir in der Lage, Ihnen zu helfen. Nicht reproduzierbare Probleme sind dagegen auch nur schwer zu analysieren.

Meldungen

...

Reduzieren Sie die Warenkorbsumme unter 99.9 Millionen.

Logs prüfen

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 Riverty API kann dann bequem mit dem Präfix “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.

Browser-Log

Das Browser-Log ist meist relevant, wenn irgendwas im Frontend des Shops sich merkwürdig verhält oder nicht reagiert. (Beispiel: Sie klicken einen Button und augenscheinlich passiert gar nichts.)

Das Browser-Log sehen Sie, wenn Sie im Browser F12 drücken und dort dann auf Konsole (oder Console) wechseln.

Shop-Log

Das Shop-Log ist immer dann interessant, wenn im Frontend unerwartete Fehlermeldungen ausgegeben werden oder das Plugin zwar auf Eingaben im Frontend reagiert, aber nicht das Ergebnis liefert, was erwartet wurde. Manchmal ergibt sich auch durch das Browser-Log, dass die Informationen eher im Shop-Log zu suchen sind.

...

Webserver-Log

Das Webserver-Log wird dann relevant, wenn Sie irgendwo auf einen Error 500 (= weiße Seite) stoßen.

...

Changelog

v1.1.0 (November 2022)

• Rebranding Riverty

• Erweiterung: Logging der API-Kommunikation in Shop-Log

v1.0.8 (Oktober 2022)

• Keine Übertragung von Kundendaten bei der Ermittlung verfügbarer Zahlungsmethoden

v1.0.7 (Oktober 2022)

• Fix: Doppelte Deklaration entfernt

v1.06 (August 2022)

• Separate Einstellungen für die Aktivierung einzelner Zahlungsarten

• API Zugangsdaten Prüfung auf der Hilfeseite/Hilfe-Tab)

v1.0.5 (Juli 2022)

• Fix: IP Addresse bestimmen / validieren

v1.0.4 (Juni 2022)

• Aktualisierung der Rechtstexte

• AfterPay Profile Tracking hinzugefügt

• Credentials Check (Prüfung der API Zugangsdaten)

v1.0.3 (Mai 2022)

• Fix: API Url

v1.0.2 (April 2022)

• Aktualisierung der Rechtstexte für Deutschland

• Fix: DirectDebit Setter korrigiert

• Fix: Validierung zusätzlicher Adressfelder

• Redundaten Code entfernt

v1.0.1 (März 2022)

• Fix: Prüfung auf Bestellbestätigungsseite, ob mit AfterPay bezahlt wurde

• Fix: API-URL korrigiert

• Anzeige der Zahlarten im Checkout mit AfterPay-Logo

• Merchant-ID ist nun optional in den Plugin-Einstellungen

v1.0.0 (September 2021)

• Initiales Release

Support und Kontakt

siehe Support und Kontakt