Riverty Payment: Fehlerbehebung und FAQ
Fehlerbehebung für Riverty für OXID eShop 7 - fehlende Länder im Checkout, Signaturfehler, Cronjob-Fehler und Integration-API, plus FAQ.
Riverty Payment: Fehlerbehebung und FAQ
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
FAQ
Welche Zahlarten unterstützt das Modul?
Rechnungskauf, Lastschrift, Ratenzahlung (Fixed Instalments) und Pay in 3 (nur in den Niederlanden). Welche davon ein Kunde sieht, hängt zusätzlich von deinem Riverty-Vertrag und dem Warenkorbbetrag ab.
Funktioniert das Modul mit allen OXID-Editionen?
Ja, es setzt OXID eShop 7.3 oder neuer voraus (CE, PE oder EE).
Brauche ich für jedes Land einen eigenen API-Key?
Ja. Pro Land trägst du ein eigenes Key-Paar (Test und Live) ein. Ein Land ohne passenden Key ist nicht aktiv.
Kann ich das Modul erst im Sandbox-Modus testen?
Ja, der Sandbox-Modus ist pro Land unabhängig schaltbar. Live-Betrieb in einem Land und Test in einem anderen ist möglich.
Warum sehen Kunden nicht immer alle Zahlarten im Checkout?
Das Modul fragt bei jedem Aufruf der Zahlartenauswahl bei Riverty ab, welche Zahlarten für Land und Warenkorbbetrag verfügbar sind. Ratenzahlung erscheint z.B. erst ab einem Mindestbetrag. Das ist normales Verhalten. An Riverty gehen dabei nur Land, Währung, Beträge und Sprache, keine Kundendaten.
Wann wird die Zahlung eingezogen (Capture)?
Immer manuell: im Riverty-Tab der Bestellung oder über die Integration API. Eine automatische Einziehung beim Versand gibt es nicht.
Fehlerbehebung (Shopbetreiber)
| Symptom | Prüfung | Lösung |
|---|---|---|
| Riverty-Zahlarten fehlen komplett im Checkout | Wurde nach dem Eintragen der Keys "Zahlarten abfragen & synchronisieren" geklickt? Ist die Zahlart aktiv und dem Land zugeordnet? | Button klicken, die Liste "Konfigurierte Riverty-Zahlarten" prüfen |
| Land erscheint nicht im Checkout trotz Konfiguration | Passt der hinterlegte API-Key zum Sandbox-Schalter (Test-Key bei Sandbox an, Live-Key bei Sandbox aus)? | Fehlenden Key ergänzen, danach erneut synchronisieren |
| Ratenzahlung fehlt bei kleinem Warenkorb | Liegt der Betrag unter dem Mindestbetrag? | Normales Verhalten, Riverty blendet die Zahlart aus |
| Pay in 3 fehlt | Ist der Kunde in den Niederlanden und NL konfiguriert? | Pay in 3 gibt es nur für NL |
| Alle Riverty-Zahlarten verschwinden für einen Kunden | Hat Riverty die Bestellung zuvor in der Risikoprüfung abgelehnt? | Beabsichtigt, gilt nur für die laufende Sitzung |
| Kunde aus NO/SE/DK/FI kommt nicht weiter | Hat er die Personennummer eingegeben? | Pflichtfeld im Checkout, siehe Storefront |
| Signatur-Fehler bei Rückkehr von Riverty | Stimmt der API-Key des Landes mit dem bei der Autorisierung verwendeten überein? | Sandbox/Live-Verwechslung für das Land ausschließen |
| Zahlung nach Rückkehr abgelehnt, obwohl bei Riverty erfolgreich | API-Logs für den Typ lookup prüfen |
Schlägt der Status-Abgleich fehl, lehnt das Modul sicherheitshalber ab |
| Bestellung nach "Ausgewählte einziehen" nicht als bezahlt markiert | Welche Aktion wurde verwendet? | Diese Aktion setzt Bezahldatum und Ordner nicht, siehe Konfiguration |
Das API-Log unter Riverty > API Logs ist der erste Anlaufpunkt. Mit dem Filter "Typ" und der Bestellreferenz grenzt du einzelne Zahlungen ein.
Fehlerbehebung (Entwickler / Integration)
| Symptom | Prüfung | Lösung |
|---|---|---|
oe:riverty:cleanup bricht ab: Einstellung nicht konfiguriert |
Neue Einstellungen nach Update in der Konfiguration vorhanden? | oe:module:apply-configuration ausführen oder Modul reaktivieren |
| Integration API liefert 403 | Ist "Externe Integration API aktivieren" an? | Im Admin aktivieren und speichern |
| Integration API liefert 503 | Ist ein Secret generiert? | Im Admin "Neues Secret generieren" klicken (wird nur einmal angezeigt) |
| Integration API liefert 401 | Stimmt der Header X-Riverty-Integration-Secret? |
Secret prüfen oder neu generieren |
| Integration API liefert dauerhaft 409 | Hängt eine Idempotency-Key-Reservierung? | Tabelle mmd_riverty_idempotency_keys prüfen, betroffene Zeile ggf. löschen |
Integration API liefert 400 mit capture_number_required |
Wurde der Artikel in mehreren Captures eingezogen? | captureNumber im Refund-Request mitsenden |