Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-21.md
T

8.1 KiB

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

  • Ein zentraler, reiner Payment-Policy-Contract definiert die exakte Grenze: 100.000 Cent erlaubt SEPA, 100.001 Cent verlangt Karte.
  • Basisplan- und Planwechsel-Previews zeigen oberhalb der Grenze nur die aktuell verfügbare Mollie-Kartenmethode.
  • Ohne verfügbare Karte bricht der Basischeckout vor jeder Lago-/Mollie- Mutation mit einem sicheren Klartextzustand ab.
  • Wiederkehrende und einmalige Add-on-Käufe verwenden oberhalb der Grenze denselben Kartenvertrag.
  • Der Recurring-Worker setzt für Rechnungen oberhalb der Grenze sequenceType=recurring plus creditcard, statt directdebit aus dem technischen Katalogcode abzuleiten.
  • Die Billing-UI erklärt die Kartenpflicht, zeigt eine fehlende Karte als Fehler und deaktiviert die Checkout-Aktion.
  • Unit-, Service-, Worker-, UI-, i18n- und Grenzwerttests decken 1.000,00 EUR, 1.000,01 EUR und fehlende Kartenverfügbarkeit ab.
  • Typecheck, Lint, vollständige Testsuite und passende Billing-/Source- Verifier sind grün.
  • 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

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.