Show invoice amount and balance on the account invoices page without losing pagination

Open
#678 1 comment 0 reactions 1 assignee View on GitHub

@tungleduyxyz is already working on this.

Since Nov 5, 2026.

  • #681 by @tungleduyxyz — open

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
html
Domain
frontend, payments

Research direction

Start by reading the account invoices page implementation and its paginated invoice API calls, then trace how Edit Columns controls visibility. Check how invoice details and loading placeholders are handled elsewhere in the UI. Done means the current page still uses pagination, visible Amount and Balance columns load values for only that page, hidden columns trigger no extra calls, and pagination continues to work.

Written by the indexing model from the issue text.

Description

Background

#329 switched the account invoices page to the paginated account invoices API (see killbill/killbill#1272 and killbill/killbill#1792). Some customers have accounts with hundreds or thousands of invoices and subscriptions, and the page wouldn't load for them before this change.

The paginated API returns shallow invoices with no invoice components. Because of that, the Amount and Balance columns are empty or show 0 on the account invoices page. Users only see the real values after opening each invoice.

Problem

We have two groups of users whose needs conflict:

  1. Accounts with a large invoice history need the page to load quickly. Fetching every invoice with its components isn't an option for them.
  2. Most other users expect to see the amount and balance in the invoice list, as they could before #329. One customer has now reported the missing values as a regression.

Proposed Solution

Keep pagination as the default, and fetch amount and balance only for the invoices on the current page:

  1. Load the page as today. Use the paginated API to get the invoices for the current page.
  2. Fill in amount and balance for that page only. Once the page is shown, fetch the full details of just those invoices (asynchronously) and populate the Amount and Balance columns. The cost then depends on the page size, not on how many invoices the account has. Show a loading placeholder in those cells while the values load.
  3. Let users choose the columns in Edit Columns. List Amount and Balance there like the other columns. Users who don't need them can hide them, and Kaui skips the extra calls when they're hidden.

References

  • killbill/killbill-admin-ui#329
  • killbill/killbill#1272
  • killbill/killbill#1792
Dominant language
HTML
Stars
70
Forks
76
Avg merge
1d 23h
Merged PRs (30d)
5

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from killbill/killbill-admin-ui

All issues in killbill/killbill-admin-ui

Similar issues

More Web Dev issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.