Darstellung
Mollie (SYS14)
Transaktion: SYS14 Mollie
UI-Pfad: /mollie
Business-Zweck
Mollie verbindet reybex per OAuth mit Mollie als Zahlungs-/Bank-Provider. Nach erfolgreicher Authentifizierung können Zahlungseingänge in Finanzen (FIN) importiert und Bankkonten synchronisiert werden (BankCredential, FigoAccount).
Kernbegriffe
| Begriff | Bedeutung |
|---|---|
| BankCredential | OAuth-Token-Speicher für Banking-Provider |
| MollieClient | API-Client für Mollie OAuth |
| isConnected | Verbindungsstatus in UI |
| state / code | OAuth-Flow-Parameter |
Fachlicher Ablauf / Workflow
- User öffnet SYS14 →
GET /api/mollie/zeigt Verbindungsstatus - Verbindung starten:
GET /api/mollie/connectliefert OAuth-URL - Callback mit
codeundstate:POST /api/mollie/authoderGET /api/mollie/?code=…&state=… - Token wird in
BankCredentialgespeichert (verschlüsselt) - FIN-Banking nutzt Konto für Zahlungsabgleich
Partner-Szenarien
| Szenario | Bezug |
|---|---|
| Shop-Zahlungen automatisch abgleichen | FIN Offene Posten |
| Multi-Store | Ein Mollie-Konto pro Mandant |
| Token abgelaufen | Erneut verbinden (OAuth Refresh) |
Voraussetzungen
- Mollie-Organisationskonto
- FIN-Modul gebucht
- HTTPS-Callback-URL in Mollie-App
Typische Fehlerquellen
- bankCredential.by.state.not.found – OAuth-State abgelaufen
- Nicht verbunden –
isConnected: false - FIN-Import leer – Falsches Bankkonto / Zeitraum