Usage Metering & Billing Pipeline  ·  View 08 of 22  ·  Structure

Integration and Interface Catalogue

Four inbound contracts, four outbound, and the replay property that makes the outbound ones safe.

Editable source SVG draw.io All views
Inbound Product services HTTPS batch · async Edge & CDN nodes minute rollup · async Partner feeds signed objects · batch Internal consoles pricing, close, restate Platform Metering & Billing Pipeline AWS · 6 public endpoints Outbound Tax engine REST · per line Payment platform invoice.issued · async ERP & revenue recognition IDoc · nightly Customer surfaces REST, console, webhooks events egress backfill control lines issued nightly usage Integration and Interface Catalogue Application we own External / third party event / async batch synchronous Protocol and cadence sit on each node, not on the arrows. Customer threshold webhooks ride the customer-surfaces contract; the nightly warehouse extract is omitted because it reads the same ledger as the evidence query in view 15. v 1.0 · owner Architecture Practice · date 2026-10

Decisions

  • One inbound event contract for product services, edge nodes and partner feeds. A separate partner path would need its own deduplication and its own validation, and would be the first thing to drift.
  • Every outbound interface is fed from a durable outbox, so a downstream outage costs latency and never an invoice. This is what lets the invoice run complete regardless of the payment platform's health.
  • Internal consoles are modelled as one inbound interface because they share an authorisation model and an audit path, even though they serve three different actors.

Assumptions

  • Downstream consumers are idempotent on invoice identifier, which is what makes replay safe (stated assumption, and a contract worth writing down with each owner).
  • Partner feeds arrive as signed objects at most daily, so backfill never competes with live ingestion for capacity.

Accepted clutter

  • Two route-check clutter warnings remain on this view: two edge labels sit close to a neighbouring line. Shortening them further would cost the reader the cadence information, and reducing the catalogue below four interfaces a side would defeat the view's purpose.