Skip to main content

Self Top-up Improvement — V3 Balance Types & New Flow

Initiative owned by the Bifrost team. Improves the existing self-service top-up flow for Billing V3 clients by adding new balance types (User Quota, Voice, AI Dialog), enforcing minimum amounts on existing types (WhatsApp, MUV), introducing a Review Order confirmation step, and surfacing excess usage inline. The improved flow is gated behind both the billing_new_topup preference flag and billing_version = "3", leaving non-V3 CIDs entirely unaffected.

Scope Changes​

  • Backend — Mekari Billing package pricing API integration (BIF-7869); new TopupConfiguration entries for User, Voice, and AI Dialog balance types; V3 + feature flag gating logic in NewBillingTopup repository
  • Frontend — New and updated balance type sections on /billing/topup in hub-chat; Review Order page with confirmation popup; excess usage display when balance < 0

Delivery status (Commit — as-built, Jira-verified 2026-07-01)​

The build is materially complete (~90%, 19.9 / 22 md), and the initiative has moved from Tentative to Commit on the team readiness dashboard. An as-built reconciliation against the five repos and every PRD-cited Jira ticket (rfcs/self-topup.task-breakdown.md v2.3) found Phase 1 (UI) and Phase 2 (API integration) shipped — the FE 12.5 and BE 5 are already spent, not Q3-forward work. What remains (~2.1 md, no new features) is:

  • PO sign-off — done, 10 of 10. All PRD-cited Stories (BIF-7869–7878) resolved Done in Jira on 2026-07-01, across two review passes the same day.
  • QA E2E BIF-8382 (In Testing) — the only open item (~2 md), owned by Yoddi/Izzul, well within the ~2-month runway to the 2026-08-31 commitment date; no capacity concern.
  • Doc/linkage fixes — 3 of 4 done. PRD Epic corrected to BIF-7797, RFC link added, and the excess-usage row's empty Jira cell filled (BIF-8175) directly in prds/self-topup.md. Still open (optional): the scope-addition note.
  • Conditional STP-S04 paid_pi contract-end-date BE fix (+1.5 md) only if the E2E surfaces the gap.
  • Epic priority — decided and mirrored to Jira 2026-07-01. TPM confirmed BIF-7797 stays in 26Q3, deprio lifted (see delivery/decisions/0001-lift-bif-7797-deprio-confirm-26q3.md). BIF-7797 itself moved To Do → In Progress in Jira the same day, confirming the deprio is lifted on the board, not just documented here.

QA Lane​

Lane B — keeps a human QA gate. Money-critical: payment flows and balance top-up directly affect client billing and service availability. No E2E test specs exist for this initiative yet. Classified 2026-06-29.