English Version

Zurück zur Übersicht

Riverty Payment: Technische Details

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Überblick

Flow 1: Checkout und Redirect

graph TD
    A["Kunde waehlt Riverty-Zahlart"] --> B["Authorize-Request aufbauen"]
    B --> C["RivertyClient: authorize()"]
    C --> D{"Ergebnis?"}
    D -->|Accepted| K["OXID Order-Finalisierung laeuft durch"]
    D -->|Pending| E["Warenkorb in Session sichern, Redirect zu Riverty"]
    D -->|Rejected| F["Fehlermeldung, zurueck zur Zahlartenauswahl"]
    E --> G["Kunde bestaetigt bei Riverty"]
    G --> H["Return-Controller mmd_riverty_return"]
    H --> I["Signatur pruefen oder Order-Lookup"]
    I -->|Akzeptiert| J["Warenkorb wiederherstellen, Bestellung abschliessen"]
    I -->|Abgelehnt oder Fehler| F
    J --> K
    K --> L["Danke-Seite mit Riverty-Infobox"]

Die Rückkehr verifiziert je nach Rücksprung entweder die Signatur (Parameter ordernumber, orderstatus, signature, geprüft mit dem API-Key des Landes) oder fragt den Bestellstatus per Lookup ab. Schlägt der Lookup fehl, wird die Zahlung sicherheitshalber abgelehnt.

Flow 2: Order Management (Admin oder Integration API)

graph TD
    A["Admin-Aktion oder Integration API Request"] --> B{"Herkunft?"}
    B -->|Integration API| C["Secret-Auth und Idempotency-Check"]
    B -->|Admin-Tab| D["Order-Aktion ausfuehren"]
    C --> E["Restmengen berechnen"]
    D --> E
    E --> F["Riverty-API aufrufen"]
    F --> G["Transaktionsstatus aktualisieren"]
    G --> H["Post-Capture- oder Post-Void-Aktionen je nach Aktion"]
    F --> L["API-Call protokollieren"]

Controller

Datenbanktabellen

Zusätzlich legt die Zahlarten-Synchronisation Einträge in oxpayments und oxobject2payment an.

Modul-Struktur

src/
├── Core/              Aktivierungs-Events, Tabellen
├── Controller/
│   ├── Admin/         Bestell-Tab, API-Log
│   └── Api/           Integration API
├── Api/
│   ├── Request/
│   └── Response/
├── Payment/           Zahlart- und Status-Enums, PaymentHandler
├── Console/           oe:riverty:cleanup
├── Exception/
├── Config/            Konfigurations-Objekte und Factories
├── Service/
│   └── IntegrationApi/
├── Repository/
├── Model/
│   └── IntegrationApi/
└── Extension/
    ├── Controller/
    └── Model/

Chain Extending