Riverty Payments für Sylius
Riverty Buy Now Pay Later für Sylius 2 - Rechnung, Lastschrift, Ratenzahlung und Pay in X per Hosted Checkout, neun Länder, Capture, Void und Refund im Admin, dual-mode über Storefront und Shop API
Hinweis zu Riverty: Dieses Plugin ist eine unabhängige Integration und steht in keiner geschäftlichen oder vertraglichen Beziehung zu Riverty. Es wurde nicht von Riverty beauftragt, autorisiert oder geprüft. Bei Fragen oder Problemen wende dich ausschließlich an den Plugin-Support (support@markus-michalski.net). Riverty selbst übernimmt hierfür keinerlei Verantwortung oder Support. "Riverty" ist eine Marke der jeweiligen Rechteinhaberin.
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Live Demo: Teste dieses und weitere Plugins live, ohne Installation und ohne Risiko: demo.markus-michalski.net
Riverty Payments für Sylius
Riverty Buy Now Pay Later für Sylius 2: Rechnung, Lastschrift, Ratenzahlung (Fixed Instalments) und Pay in X über Riverty Hosted Checkout. Der Kunde gibt seine Zahlungsdaten beim Redirect auf der Riverty-Seite ein, nicht im Shop. Das Plugin funktioniert im Twig-Storefront und headless über die Sylius Shop API. Es richtet sich an Sylius-Shopbetreiber mit Riverty-Händlervertrag, die in DE, AT, CH, NL, BE, NO, SE, DK oder FI verkaufen.
Die Anbindung von Riverty besteht aus mehr als einem Redirect: API-Keys pro Land, Verfügbarkeitsprüfung, Capture, Void und Refund, Abgleich offener Zahlungen und ablaufende Reservierungen. Dieses Plugin übernimmt das alles. Du konfigurierst und verwaltest Bestellungen im Sylius-Admin, ganz ohne eigenen Code.
graph LR
A["Storefront (Twig)"] --> C["Sylius Payment Request"]
B["Shop API"] --> C
C --> D["Riverty Plugin"]
D --> E["Riverty API"]
E --> F["Hosted Checkout"]
F --> G["Kunde kehrt zurück oder wird abgeglichen"]
G --> H["Zahlung autorisiert"]
H --> I["Capture, Void, Refund im Admin"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Composer-Installation, Routen, Setup-Befehl, Update, Deinstallation |
| Konfiguration | API-Keys pro Land, Zahlarten anlegen, Vertrag prüfen, Optionen, API-Log |
| Bestellverwaltung | Capture, Void und Refund, Teilmengen, Capture beim Versand |
| Abgleich und Ablauf | Offene Zahlungen abgleichen, 30-Tage-Reservierung, Digest-Mail, Cronjob |
| Storefront | Zahlarten im Checkout, Ratenbeispiel, Identifikationsnummer, Danke-Seite |
| Shop API | Headless-Betrieb über Sylius Payment Requests, Grenzen |
| Erweiterbarkeit | Service-Tags, austauschbare Interfaces, Events |
| Fehlerbehebung | Häufige Probleme, bekannte Einschränkungen, FAQ |
| Technik | Ablauf-Diagramm, Plugin-Struktur, Tabellen |
Features
| Feature | Beschreibung |
|---|---|
| Hosted Checkout | Zahlung über Riverty per Redirect, Zahlungsdaten werden nicht im Shop erfasst |
| Vier Zahlarten | Rechnung, Lastschrift, Ratenzahlung (Fixed Instalments) und Pay in X (nur Niederlande) |
| Neun Länder | Ein API-Key-Paar (Test und Live) pro Land: DE, AT, CH, NL, BE, NO, SE, DK, FI |
| Zahlarten per Klick | Ein Button legt die Riverty-Zahlarten für einen Channel an, ein zweiter fragt ab, was dein Vertrag bietet |
| Verfügbarkeit von Riverty | Der Checkout bietet nur die Zahlarten an, die Riverty für den Warenkorb meldet |
| Capture, Void, Refund | Direkt auf der Bestellseite im Admin, auch für Teilmengen und pro Capture |
| Capture beim Versand | Optional: Was offen ist, wird erfasst, sobald die letzte Lieferung versendet ist |
| Abgleich offener Zahlungen | Riverty kennt keinen Webhook, ein Konsolenbefehl holt verpasste Rückkehrer nach |
| Ablauf-Überwachung | Warnung vor dem Ende der 30-Tage-Reservierung auf der Bestellseite und per täglicher Digest-Mail |
| API-Log | Jeder Aufruf an Riverty wird protokolliert, personenbezogene Daten werden maskiert |
| Bestellhistorie | Optional: Ob und wie viel von der früheren Bestellhistorie des Kunden an Riverty geht, standardmäßig nichts |
| Identifikationsnummer | Für Norwegen, Schweden, Dänemark und Finnland ein Feld im Zahlungsschritt, verschlüsselt gespeichert |
| Ratenbeispiel | Optional mit Repräsentativbeispiel nach § 6a PAngV im Checkout |
| Dual-Mode | Storefront und Shop API nutzen denselben Zahlungsweg |
Anforderungen
| Anforderung | Version | Hinweis |
|---|---|---|
| Sylius | ^2.2 | Getestet mit 2.2 und 2.3 |
| PHP | ^8.3 | Erweiterungen mbstring und openssl |
| Symfony | ^7.4 | |
| Datenbank | MySQL oder MariaDB | Die Migrationen sind MySQL-DDL, PostgreSQL wird nicht unterstützt |
| Riverty | Händlerkonto | Ein API-Key pro Land, in dem du verkaufst |
APP_SECRET |
Nicht leer, dauerhaft gleich | Aus ihm wird der Schlüssel für gespeicherte API-Keys abgeleitet |
| Payment-Request-Transport | sync:// |
Das Sylius-Standardverhalten, siehe Installation |
| State-Machine-Adapter | symfony_workflow |
Sylius-Standard, nötig für Capture beim Versand und das Sperren der Sylius-Buttons |
Lizenz
Kommerzielle Lizenz.
Support
E-Mail: support@markus-michalski.net