English Version

Zurück zur Übersicht

Riverty Payments: Storefront

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Welche Zahlarten der Checkout anbietet

Riverty wird nur angeboten, wenn die Rechnungsadresse in einem Land liegt, für das der Channel einen API-Key hat, und die Bestellung in der Währung läuft, die Riverty dort akzeptiert (zum Beispiel EUR in Deutschland). Warum eine Zahlart fehlt, erklärt der Admin auf der Liste der Einstellungen, siehe Konfiguration.

Zusätzlich zu diesen lokalen Prüfungen fragt das Plugin Riverty, welche Zahlarten für den Warenkorb angeboten werden, und listet nur diese. Eine Ratenzahlung verschwindet deshalb bei einem Betrag, für den Riverty keinen Plan hat.

• Riverty wird einmal pro Warenkorb gefragt, die Antwort wird fünf Minuten zwischengespeichert (cache.app).
• Ist Riverty nicht erreichbar, wird nichts weggenommen: Die Zahlarten, die die lokalen Prüfungen bestanden haben, bleiben, und die Autorisierung sagt im Zweifel Nein.
• Antwortet Riverty mit einer Ablehnung oder gar keiner Zahlart, wird keine Riverty-Zahlart angeboten.

Was der Kunde sieht

Zahlungsschritt

Die gewählte Riverty-Zahlart zeigt einen kurzen Text mit dem Riverty-Logo, der die Zahlungsart erklärt (Rechnung, Lastschrift, Ratenzahlung, Pay in X), auf Englisch und Deutsch. Die Texte aller Zahlarten stehen in der Seite, und eine CSS-Regel (:has()) zeigt den Text hinter dem gewählten Radiobutton. Der Wechsel ist deshalb sofort und braucht keine Anfrage an den Server. Ein Browser ohne :has() zeigt alle Texte.

Ratenbeispiel (optional)

Das Einstellungsformular hat pro Channel die Option Ratenkauf-Beispiel im Checkout anzeigen, standardmäßig aus. Ist sie an, zeigt der Text der Ratenzahlung zusätzlich "ab X/Monat" und das Repräsentativbeispiel des günstigsten Plans, den Riverty für den Warenkorb anbietet: Nettodarlehensbetrag, Sollzinssatz, effektiver Jahreszins, Laufzeit, monatliche Rate und Gesamtbetrag.

Wer in der Werbung einen Monatsbetrag nennt, löst die Pflichten aus § 6a PAngV aus. Deshalb wird das vollständige Beispiel immer mit gezeigt, und ein Plan, dem eine der Angaben fehlt, wird nie genannt. Schalte die Option nur ein, wenn du das willst.

Ob die Ratenzahlung überhaupt angeboten wird, hängt nicht von der Option ab. In eigenen Templates steht das Beispiel als mmd_riverty_instalment_plan() zur Verfügung. Die Funktion liefert teaser, net_amount, interest_rate, apr, term, rate und total oder null, wenn es keinen vollständigen Plan gibt. Ohne Argument nutzt sie den aktuellen Warenkorb, übergeben kannst du auch eine Bestellung oder eine Zahlung.

Identifikationsnummer (Norwegen, Schweden, Dänemark, Finnland)

Für eine Rechnungsadresse in einem dieser Länder braucht Riverty die persönliche Identitätsnummer eines Privatkunden oder die Registrierungsnummer eines Unternehmens. Der Zahlungsschritt zeigt dann ein Feld Identifikationsnummer. Es erscheint, solange eine Riverty-Zahlart gewählt ist, und ist nur für Riverty Pflicht.

• Die Prüfung ist bewusst großzügig: 6 bis 20 Zeichen, Ziffern, Buchstaben und + - / ., das erste Zeichen ist eine Ziffer oder ein Buchstabe, mindestens drei Ziffern stehen hintereinander, Leerzeichen werden entfernt. Die Formate von vier Ländern für Personen und Firmen unterscheiden sich, die eigentliche Prüfung macht Riverty.
• Die Nummer wird verschlüsselt in den Details der Zahlung gehalten (mit dem aus APP_SECRET abgeleiteten Schlüssel, wie die API-Keys) und entfernt, sobald Riverty gefragt wurde, egal ob Riverty die Bestellung angenommen hat oder nicht. Sie wird nie unmaskiert protokolliert.
• Wählt ein Kunde eine andere Zahlart, bleibt keine Nummer zurück.
• Bestellungen in die Nordics brauchen außerdem die Währung, die Riverty dort erwartet (NOK, SEK, DKK, in Finnland EUR).

Das Feld gehört zum Storefront-Checkout. Die Sylius Shop API kann die Nummer im Zahlungsschritt nicht tragen, siehe Shop API.

Bestätigungsseite

Nach einer Zahlung mit Riverty zeigt die Bestätigungsseite einen Hinweis mit einem Link zu MyRiverty, wo der Kunde offene Zahlungen verfolgt.

Twig-Hooks

Das Plugin hängt sich an diese Hooks:

Der Hook-Name der ersten Zeile trägt den Gateway-Factory-Namen riverty: Sylius rendert choice.<factory> und choice und führt beide Listen zusammen, die Karte der Zahlart aus dem Core bleibt also stehen und das Plugin ergänzt den Text dahinter.

Eigene Templates und Themes

Ersetzt ein Theme eines der Templates, die an diesen Hooks hängen, entfällt die Ausgabe dort. Ersetze in dem Fall nicht das ganze Template, sondern hänge dich mit einem eigenen Hook-Eintrag und höherer Priorität an die Hook-Namen aus der Tabelle. Weitere Twig-Funktionen für eigene Templates: