Readiness
:::info Source
Sourced from services/billing-service/SERVICE_READINESS.md in the documentation repo.
:::
1. Level per Milestone
| M | Level | Scope |
|---|---|---|
| M0 | — | PSP + tax vendor eval |
| M1 | — | Billing ACL design |
| M2 | L3 | Payment processing + invoicing + first revenue |
| M3 | L3 | Tax enhancements |
| M4 | L3 | Subscriptions + dunning |
| M5 | L4 | Multi-currency + payouts + Connect + compliance-ready |
2. Gates
G1 Domain
- Subscription, Invoice, Payment, Refund, Dunning, Payout aggregates + invariants.
- State machines tested.
- Money type in micro-units.
- 95% unit / 80% mutation.
G2 API
- OpenAPI; idempotency; problem+json; cursor.
- Stripe webhook endpoint documented.
- Pact with marketplace, notification, analytics.
G3 Events
- Subjects registered; outbox + inbox.
- DLQ + replay tooling.
G4 Sync
- Invoices, Subscriptions, PaymentMethods replicable
server_authoritative.
G5 AI
- Dunning personalization + fraud scoring via AIClient (advisory).
- Bias monitoring quarterly.
G6 Observability
- Revenue, dunning, payout, webhook dashboards.
- Reconciliation variance alert.
G7 Performance
- Payment intent p95 < 500ms.
- Webhook processing p95 < 200ms.
- 100k subscription renewals in < 10 min.
G8 Security
- PCI SAQ-A verified.
- Tokenization end-to-end.
- Webhook HMAC + replay protection.
- Two-tenant iso green.
3. SLOs
| SLI | Target |
|---|---|
| Payment intent creation p95 | < 500ms |
| Webhook processing p95 | < 200ms |
| Webhook success rate | ≥ 99.9% |
| Reconciliation variance | < 0.01% |
| API availability | 99.95% |
4. DoD
- Tests green (including PCI no-PAN log scan).
- Stripe mock scenarios pass.
- Pact + OpenAPI verified.
- Two-tenant iso.
- Reconciliation snapshot green.
5. Release Checklists
S3 (M2 — First Revenue)
- Payment saga step GA.
- Webhook handling GA.
- Basic invoicing.
- Refund flow.
- Tax calculation US + EU.
M4 (Subscriptions + Dunning)
- Subscription lifecycle complete.
- Trial conversion flow.
- Dunning multi-stage tested.
- Dispute handling.
M5 (Payouts + Multi-currency)
- Stripe Connect integration GA.
- Provider payouts weekly.
- Multi-currency (USD, EUR, GBP, AED, INR).
- Reconciliation across currencies.
- SOC 2 Type II audit-ready.