160 lines
8.1 KiB
Markdown
160 lines
8.1 KiB
Markdown
# BILL-21 · Mollie-Zahlungen über 1.000 € ausschließlich per Karte einziehen
|
|
|
|
| | |
|
|
| ----------------- | --------------------------------------------- |
|
|
| **Typ** | Launch-Fix · Billing-/Payment-Sicherheit |
|
|
| **Owner** | Raffael |
|
|
| **Phase** | Pilot-Härtung |
|
|
| **Cycle/Fenster** | gestartet 2026-08-02 |
|
|
| **Status** | Done |
|
|
| **Plane** | HIVEGRID-242 |
|
|
|
|
## Abhängigkeiten & Parallelität
|
|
|
|
- **Blocked by:** `BILL-11` definiert Katalog und invoice-getriebenes
|
|
Recurring, `BILL-13` die Mollie-Methodenauswahl und `BILL-14` den
|
|
Registrierungs-/Erstkaufpfad. Alle drei Tickets sind Done.
|
|
- **Blocks:** `BILL-08` Production-Aktivierung. Der bisherige externe Blocker
|
|
„SEPA-Limit anheben“ wird durch einen fail-closed Kartenvertrag ersetzt.
|
|
- **Abhängigkeitsschutz:** Preise, Vertragslaufzeit, technische
|
|
`annual_sepa`-Codes, Lago-Rechnungen, Entitlements und Hosted Checkout
|
|
bleiben unverändert. Der Code ist aus Kompatibilitätsgründen weiterhin ein
|
|
Katalogname, aber keine Zusage, Zahlungen oberhalb des Providerlimits per
|
|
Lastschrift einzuziehen.
|
|
|
|
## Was / Warum
|
|
|
|
Mollie dokumentiert für SEPA Direct Debit standardmäßig maximal 1.000 EUR je
|
|
Transaktion. Colony kostet bereits ohne Zusatznutzer oder Speicher 899 EUR
|
|
netto beziehungsweise 1.069,81 EUR brutto. HiveGrid filterte bei
|
|
12-Monatsverträgen Karten bislang vollständig heraus und erzwang im Worker
|
|
später erneut `directdebit`. Im aktivierten Testprofil blieb dadurch sichtbar
|
|
nur iDEAL: Die kundenpräsente iDEAL-Erstzahlung erzeugt ein SEPA-Mandat, löst
|
|
aber das Limit der späteren Lastschrift nicht.
|
|
|
|
Der verbindliche Vertrag lautet:
|
|
|
|
- Bis einschließlich 1.000,00 EUR brutto bleibt die bisherige, von Mollie für
|
|
`sequenceType=first` freigegebene Mandatsauswahl gültig.
|
|
- Ab 1.000,01 EUR brutto ist `creditcard` die einzige zulässige Methode.
|
|
- Dieselbe Grenze gilt für Basisplan-, Änderungs- und Add-on-Checkouts sowie
|
|
für die invoice-getriebene wiederkehrende Zahlung.
|
|
- Bietet das konkrete Mollie-Profil für den Betrag keine Karte an, bricht
|
|
HiveGrid vor Lago-/Mollie-Mutationen ab und erklärt den Zustand im UI.
|
|
|
|
## Nicht im Scope
|
|
|
|
- Keine eigenen Kartenfelder, kein Iframe und keine Speicherung von Karten-,
|
|
Bank- oder Mandatsdaten in HiveGrid.
|
|
- Keine Preis-, Rabatt-, Vertragslaufzeit-, Steuer- oder Entitlement-Änderung.
|
|
- Keine Production-Live-Zahlung und keine Umgehung der übrigen `BILL-08`-Gates.
|
|
- Keine automatische Aufteilung einer Rechnung in mehrere Teilzahlungen.
|
|
|
|
## Definition of Done
|
|
|
|
- [x] Ein zentraler, reiner Payment-Policy-Contract definiert die exakte
|
|
Grenze: 100.000 Cent erlaubt SEPA, 100.001 Cent verlangt Karte.
|
|
- [x] Basisplan- und Planwechsel-Previews zeigen oberhalb der Grenze nur die
|
|
aktuell verfügbare Mollie-Kartenmethode.
|
|
- [x] Ohne verfügbare Karte bricht der Basischeckout vor jeder Lago-/Mollie-
|
|
Mutation mit einem sicheren Klartextzustand ab.
|
|
- [x] Wiederkehrende und einmalige Add-on-Käufe verwenden oberhalb der Grenze
|
|
denselben Kartenvertrag.
|
|
- [x] Der Recurring-Worker setzt für Rechnungen oberhalb der Grenze
|
|
`sequenceType=recurring` plus `creditcard`, statt `directdebit` aus dem
|
|
technischen Katalogcode abzuleiten.
|
|
- [x] Die Billing-UI erklärt die Kartenpflicht, zeigt eine fehlende Karte als
|
|
Fehler und deaktiviert die Checkout-Aktion.
|
|
- [x] Unit-, Service-, Worker-, UI-, i18n- und Grenzwerttests decken 1.000,00
|
|
EUR, 1.000,01 EUR und fehlende Kartenverfügbarkeit ab.
|
|
- [x] Typecheck, Lint, vollständige Testsuite und passende Billing-/Source-
|
|
Verifier sind grün.
|
|
- [x] Plane, abhängige Ticket-Docs und Change-Request dokumentieren Ergebnis,
|
|
Proof und verbleibende Production-Gates konsistent.
|
|
|
|
**BILL-21: 9/9 DoD = 100 % done. Kein selbst machbarer Punkt offen.**
|
|
|
|
2026-08-02 · Abhängigkeitsschutz für `BILL-22`
|
|
|
|
- `BILL-22` erhält die harte Grenze von 100.000/100.001 Cent, öffnet darunter
|
|
aber die kundenseitige Wahl einschließlich Kreditkarte. Außerdem wird der
|
|
hier gefundene Worker-/Gateway-Widerspruch geschlossen: Recurring-Karte ist
|
|
nur mit passendem gültigem Mandat zulässig; ein fehlendes Mandat bleibt
|
|
fail-closed und fällt nie auf SEPA zurück.
|
|
|
|
2026-08-02 · Release-Proof
|
|
|
|
- PR `#354` lief auf Head `0b9351eef` mit 13/13 grünen Checks und wurde
|
|
ausschließlich per normalem Merge-Commit `86eb01825` in `main` übernommen;
|
|
die drei atomaren Feature-Commits bleiben vollständig in der Historie.
|
|
- Main-/Staging-Run `3082` sowie alle vier Main-Statuschecks sind grün. Der
|
|
Run baute und promotete die unveränderlichen Images und schloss den
|
|
Coolify-/Readiness-Pfad erfolgreich ab.
|
|
- `https://staging-app.hivegrid.de/healthz` und `/readyz` melden
|
|
`hivegrid-web`, `core`, `86eb01825af39d9c28fcd663887d3189cfeb0854` als
|
|
gesund beziehungsweise bereit. Die beiden entsprechenden Endpunkte auf
|
|
`https://staging-api.hivegrid.de` melden dieselbe Revision für `api`.
|
|
- Es wurde keine Production-Zahlung und keine Production-Promotion ausgelöst.
|
|
|
|
**BILL-21: 9/9 DoD = 100 % done. Kein selbst machbarer Punkt offen.**
|
|
|
|
## Rollback
|
|
|
|
- Der zentrale Resolver und seine drei Konsumenten können gemeinsam auf den
|
|
vorherigen Methodenvertrag zurückgesetzt werden. Bereits erzeugte Zahlungen,
|
|
Rechnungen und Mandate bleiben append-only und werden nicht gelöscht.
|
|
- Der bestehende Provider-Side-Effect-Gate kann das Recurring-Inkasso stoppen.
|
|
Ein Rollback darf niemals eine Rechnung oberhalb von 1.000 EUR automatisch
|
|
auf `directdebit` zurückfallen lassen; bis zur Korrektur bleibt sie offen.
|
|
|
|
## Quellen
|
|
|
|
- https://docs.mollie.com/docs/sepa-direct-debit
|
|
- https://docs.mollie.com/docs/cards
|
|
- https://docs.mollie.com/docs/recurring-payments
|
|
- https://docs.mollie.com/reference/create-customer-payment
|
|
- `.planning/ticket-docs/BILL-08.md`
|
|
- `.planning/ticket-docs/BILL-11.md`
|
|
- `.planning/ticket-docs/BILL-13.md`
|
|
- `.planning/ticket-docs/BILL-14.md`
|
|
|
|
## Umsetzungs-Notiz
|
|
|
|
2026-08-02 · gestartet
|
|
|
|
- Plane-Ticket `HIVEGRID-242` angelegt, Raffael zugewiesen und auf In Progress
|
|
gesetzt. Die Plane-Identität wurde als `raffael@tool-ctrl.de` geprüft.
|
|
- `blocked-by` und `blocks` wurden in Plane sowie in den vier abhängigen
|
|
Ticket-Docs in beide Richtungen gelesen. `CR-019` genehmigt den Ersatz des
|
|
externen SEPA-Limit-Gates durch die harte Kartenregel.
|
|
- Baseline vor dem ersten Edit: Typecheck grün, Core-Suite 8.244 Tests grün
|
|
(60 übersprungen), EU-Provider-Guard leer.
|
|
|
|
**BILL-21: 0/9 DoD = 0 % done. 9 Punkte selbst machbar.**
|
|
|
|
2026-08-02 · umgesetzt
|
|
|
|
- `1ff12656c` zentralisiert das dokumentierte EUR-1.000-SEPA-Limit und
|
|
erzwingt ab 100.001 Cent `creditcard` in Basis-/Änderungscheckout, Add-ons
|
|
und invoice-getriebenem Recurring-Worker. Die serverseitige Methods-Abfrage
|
|
prüft den konkreten Betrag und bricht ohne angebotene Karte vor
|
|
Lago-/Mollie-Mutationen ab.
|
|
- `70765fae3` ergänzt den expliziten Kartenstatus im View-Model, Klartext in
|
|
de/en, automatische Auswahl der einzigen Kartenmethode, deaktivierte
|
|
Checkout-Aktionen sowie UI-/A11y-Regressionsproof.
|
|
- Ein 0,00-EUR-`first`-Payment für Kreditkarte bleibt bei Trial und
|
|
periodischem Planwechsel zulässig und erzeugt laut Mollie-Dokumentation das
|
|
für die spätere Kartenbelastung benötigte Mandat. Der tatsächlich fällige
|
|
Folgebetrag steuert bereits bei dieser Autorisierung die Kartenregel.
|
|
- Proof: `pnpm typecheck`, `pnpm lint`, vollständige Core-Suite mit 1.185
|
|
Testdateien / 8.252 bestandenen Tests / 60 bewusst übersprungenen Tests,
|
|
zusätzlich 127 fokussierte Billing-/Worker-/UI-Tests sowie
|
|
`verify:i18n`, `verify:billing-boundary-baseline`, `verify:source-health`
|
|
und `verify:ci-baseline` grün. `git diff --check` ist sauber; keine
|
|
Schema-/Migration-/Secret-Änderung.
|
|
- Die verbleibenden Production-Gates sind unverändert in `BILL-08`: Mollie
|
|
Live/KYC und Legal-/Steuerfreigabe. Eine echte Production-Zahlung wurde
|
|
nicht ausgelöst.
|
|
|
|
**BILL-21: 9/9 DoD = 100 % done. Kein selbst machbarer Punkt offen.**
|