Mimir

← Back to documents

Pull Request: Harden Billing Service retry and idempotency path

github
billing
0f5476346f00

github/pr-gh-3010-billing.md

Pull Request: Harden Billing Service retry and idempotency path

ID: GH-3010 Date: 2026-04-17 Repository: acme-commerce/billing-service Service: Billing Service Owner: Revenue Platform Status: merged Type: pull request

Summary

This pull request tracks production-readiness work for the Billing Service. The concern is related to stale cache entries surviving a blue-green release. 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.