Mimir

← Back to documents

Pull Request: Harden Billing Service retry and idempotency path

github
billing
ffbefbbd7a55

github/pr-gh-3005-billing.md

Pull Request: Harden Billing Service retry and idempotency path

ID: GH-3005 Date: 2026-02-21 Repository: acme-commerce/billing-service Service: Billing Service Owner: Revenue Platform Status: open Type: pull request

Summary

This pull request tracks production-readiness work for the Billing Service. The concern is related to missing idempotency key handling in a replay worker. The implementation area touches API contracts API-BILLING-01, API-BILLING-02, service telemetry, and operational runbooks.

Engineering Notes

  • Validate that retries are bounded and idempotency keys are respected.
  • Add structured logs with service, correlation_id, and customer_impact fields.
  • Confirm dashboards show p95 latency, error rate, dependency saturation, and queue depth.
  • Cross-service impact should be reviewed with Checkout Service, Billing Service, Inventory Service, Authentication Service, and Notification Service owners when applicable.

Acceptance Criteria

  1. Contract tests cover expected and malformed payloads.
  2. Runbook references are updated for Billing Service.
  3. The change can be linked from Jira remediation tickets and incident reviews.