Add manual credit granting to the dashboard by strandhvilliam · Pull Request #15420 · polarsource/polar

strandhvilliam · 2026-10-13T20:55:44Z

Stacked on #15405, which adds the endpoint this calls.

Lets a merchant add credits to a customer's meter from the dashboard.

Screenshots
Modal

Button on each customer meter rows

Customer Meter page -- Add credit button

vercel · 2026-10-13T20:55:54Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
orbit	Ready	Preview	Oct 15, 2026 9:10am UTC
polar-test	Ready	Preview	Oct 15, 2026 9:10am UTC

cubic-dev-ai

1 issue found and verified against the latest diff

Confidence score: 3/5

useMeterCreditOptions.ts only loads the first 10 subscriptions, so a meter tied to a later active subscription can miss its overage preview. Request the maximum page size and paginate when needed.

Prompt for AI agents (unresolved issues)


Check if these issues are valid — if so, understand the root cause of each and fix them. When an issue isn't valid or won't be fixed in this PR, reply in its thread with the reason and then resolve the thread. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="clients/apps/web/src/components/Customer/AddCredits/useMeterCreditOptions.ts">

<violation number="1" location="clients/apps/web/src/components/Customer/AddCredits/useMeterCreditOptions.ts:25">
P2: This query returns only the first page, defaulting to 10 subscriptions; a meter priced by a later active subscription then has no overage preview. Request the maximum page size and paginate when necessary.</violation>
</file>

_{Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic}

cubic-dev-ai · 2026-10-13T21:03:43Z

+    })
+  const { data: subscriptions } = useSubscriptions(organizationId, {
+    customer_id: customer.id,
+    active: true,


P2: This query returns only the first page, defaulting to 10 subscriptions; a meter priced by a later active subscription then has no overage preview. Request the maximum page size and paginate when necessary.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. When an issue isn't valid or won't be fixed in this PR, reply in its thread with the reason and then resolve the thread. At clients/apps/web/src/components/Customer/AddCredits/useMeterCreditOptions.ts, line 25: <comment>This query returns only the first page, defaulting to 10 subscriptions; a meter priced by a later active subscription then has no overage preview. Request the maximum page size and paginate when necessary.</comment> <file context> @@ -0,0 +1,54 @@ + }) + const { data: subscriptions } = useSubscriptions(organizationId, { + customer_id: customer.id, + active: true, + }) + </file context>

cubic-dev-ai

All reported issues were addressed across 10 files

_{Requires human review: Auto-approval blocked because this review re-detected 3 unresolved issues already reported by Cubic.

View guided diff | Turn on auto-fix | Re-trigger cubic}

cubic-dev-ai

0 issues found across 3 files (changes from recent commits).

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{Requires human review: Auto-approval blocked by 2 unresolved issues from previous reviews.

View guided diff | Turn on auto-fix | Re-trigger cubic}

cubic-dev-ai

0 issues found across 2 files (changes from recent commits).

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{Requires human review: Auto-approval blocked by 1 unresolved issue from previous reviews.

View guided diff | Turn on auto-fix | Re-trigger cubic}

cubic-dev-ai

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{Requires human review: Auto-approval blocked by 1 unresolved issue from previous reviews.

View guided diff | Turn on auto-fix | Re-trigger cubic}

mintlify · 2026-10-14T11:57:40Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Polar	🟢 Ready	View Preview	Oct 15, 2026, 9:09 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

strandhvilliam · 2026-10-14T12:18:36Z

+      if (result.error) return
+      const queryClient = getQueryClient()
+      queryClient.invalidateQueries({ queryKey: ['events'] })
+      void waitForCreditedUnitsChange(


Implemented polling here until the credit is applied.

Another option could be to add a sse event to the existing connection the dashboard has.

😬 yeah, I understand why, but I'm not sure… Can we get away with a "It may take a while until granted credits show up" for now?

We probably could!

strandhvilliam · 2026-10-14T12:20:44Z

+
+  if (
+    !canManageCustomers ||
+    !organization.feature_settings?.config_as_code_enabled


Blocking this on the dashboard for now just to be safe. But can just roll it out directly too?

cubic-dev-ai

All reported issues were addressed across 5 files (changes from recent commits).

_{Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic}

Adds an "Add credits" side panel that grants credits on a customer meter through POST /v1/customer-meters/credits. It opens from the customer-meter page with that meter preselected, and from the customer menu with no meter selected. The panel previews the new balance and, for billed meters, how much of the current overage the credits cover. Credits always roll over and can't be removed. The entry points only show for organizations with config as code enabled and members who can manage customers.

Each meter row on the customer Usage tab gets an "Add credits" button that opens the panel with that meter preselected. Column widths give the meter name more room so the extra column fits on narrower screens.

- The panel checks the customers:manage permission itself and shows the restricted view, like the other customer modals; callers use useModal and InlineModal directly and only check the config as code flag. - The amount is a number input with form rules instead of a custom parser. - Reuse FormattedUnits and formatCurrency in the summary. - Drop the intro copy, the unit suffix and the schema-name discriminators.

- Explain an external_id conflict as a possibly already added grant instead of showing the raw API message. - Inline the panel header in both views, like the other customer modals. - Keep the overage cost helper local to getCreditPreview. - Build balance and subscription lookups by meter before mapping options.

Buttons follow the form instead of pinning to the drawer bottom, the amount is a numeric text field validated as you type, the credits field is focused when a meter is preselected, labels pluralize, and the entry points are hidden without customers:manage.

…g in add credits

…llback On mobile, Add credits sits on the title row.

The base branch renamed CustomerMeterCreditsCustomerIDCreate to CustomerMeterCreditsIDCreate and requires meter_id on that schema. Co-authored-by: Villiam Strandh <villiam.strandh@outlook.com>

Recompute the customer meter balance in the credit request instead of waiting for the debounced customer_meter.update_customer job, so the dashboard sees the new balance right after granting credits. If a worker holds the customer meter lock, fall back to activating the meter and let the debounced job pick up the credit. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

…eter When a worker holds the customer meter lock, it computed the balance from events read before the credit was committed, and create_event never enqueues customer_meter.update_customer. Enqueue it in the fallback so the credit is reflected once the request commits. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

cubic-dev-ai

0 issues found across 2 files (changes from recent commits).

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{Requires human review: Auto-approval blocked by 1 unresolved issue from previous reviews.

View guided diff | Turn on auto-fix | Re-trigger cubic}

strandhvilliam added this pull request to stack #15421 October 13, 2026 20:55

strandhvilliam changed the title ~~villiam/manual credit granting dashboard~~ Add manual credit granting to the dashboard Oct 13, 2026

vercel Bot deployed to Preview – orbit October 13, 2026 21:01

View deployment

vercel Bot deployed to Preview – polar-test October 13, 2026 21:02

View deployment

cubic-dev-ai Bot reviewed Oct 13, 2026

View reviewed changes

vercel Bot deployed to Preview – orbit October 14, 2026 06:36

View deployment

vercel Bot deployed to Preview – polar-test October 14, 2026 06:37

View deployment

cubic-dev-ai Bot reviewed Oct 14, 2026

View reviewed changes

strandhvilliam force-pushed the villiam/manual-credit-granting-dashboard branch from 7d218cb to bdd5a12 Compare October 14, 2026 06:42

vercel Bot deployed to Preview – orbit October 14, 2026 06:43

View deployment

cubic-dev-ai Bot reviewed Oct 14, 2026

View reviewed changes

vercel Bot deployed to Preview – polar-test October 14, 2026 06:44

View deployment

strandhvilliam mentioned this pull request Oct 14, 2026

Grant meter credits from the runtime SDK #15423

Merged

vercel Bot deployed to Preview – orbit October 14, 2026 11:17

View deployment

cubic-dev-ai Bot reviewed Oct 14, 2026

View reviewed changes

vercel Bot deployed to Preview – polar-test October 14, 2026 11:18

View deployment

Base automatically changed from villiam/manual-credit-granting to main October 14, 2026 11:57

mintlify Bot deployed to staging - docs October 14, 2026 11:58

View deployment

strandhvilliam force-pushed the villiam/manual-credit-granting-dashboard branch from 416de49 to fda0f64 Compare October 14, 2026 12:15

mintlify Bot deployed to staging - docs October 14, 2026 12:16

View deployment

vercel Bot deployed to Preview – orbit October 14, 2026 12:16

View deployment

vercel Bot deployed to Preview – polar-test October 14, 2026 12:17

View deployment

strandhvilliam commented Oct 14, 2026

View reviewed changes

strandhvilliam requested a review from pieterbeulque October 14, 2026 12:20

strandhvilliam marked this pull request as ready for review October 14, 2026 13:37

cubic-dev-ai Bot reviewed Oct 15, 2026

View reviewed changes

Comment thread server/polar/customer_meter/service.py Outdated

strandhvilliam and others added 18 commits October 15, 2026 11:08

clients/web: Add credits from customer usage table rows

9f75d21

Each meter row on the customer Usage tab gets an "Add credits" button that opens the panel with that meter preselected. Column widths give the meter name more room so the extra column fits on narrower screens.

clients/web: Name the duplicate credit check in the add credits panel

f0ddaf4

clients/web: Keep the add credits summary a fixed height

1714c23

clients/web: Name the customer in the add credits panel

f25a626

modify customer-meter header aligment

bf00935

clients/web: Right-align the add credits panel buttons

00bfc24

Poll for changes

ea1a673

clients/web: Match the usage table's subscription and wait for pricin…

36d7aa6

…g in add credits

clients/web: Wrap the customer meter toolbar and keep the customer fa…

ad0a7d8

…llback On mobile, Add credits sits on the title row.

clients/web: Use the split credit request schema

d200195

The base branch renamed CustomerMeterCreditsCustomerIDCreate to CustomerMeterCreditsIDCreate and requires meter_id on that schema. Co-authored-by: Villiam Strandh <villiam.strandh@outlook.com>

remove polling and config_as_code flag

453730c

copy update

19427d6

pieterbeulque force-pushed the villiam/manual-credit-granting-dashboard branch from e3739af to 0169da5 Compare October 15, 2026 09:08

mintlify Bot deployed to staging - docs October 15, 2026 09:09

View deployment

vercel Bot deployed to Preview – orbit October 15, 2026 09:09

View deployment

vercel Bot deployed to Preview – polar-test October 15, 2026 09:10

View deployment

cubic-dev-ai Bot reviewed Oct 15, 2026

View reviewed changes

strandhvilliam added this pull request to the merge queue Oct 15, 2026

Merged via the queue into main with commit 3afef32 Oct 15, 2026
32 checks passed

strandhvilliam deleted the villiam/manual-credit-granting-dashboard branch October 15, 2026 09:21

This was referenced Oct 20, 2026

docs: document manual meter credits #15707

Merged

docs(changelog): September and October product updates #15723

Merged

Conversation

strandhvilliam commented Oct 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented Oct 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot Oct 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

mintlify Bot commented Oct 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

strandhvilliam Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

pieterbeulque Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

strandhvilliam Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

strandhvilliam Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

pieterbeulque Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

strandhvilliam commented Oct 13, 2026 •

edited

Loading

vercel Bot commented Oct 13, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

mintlify Bot commented Oct 14, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading