Gitpulse
Merged
Size
M
Change Breakdown
Refactor75%
Maintenance25%
#28489refactor(core): Rename AI Gateway credits to wallet with USD amounts (backport to release-candidate/2.17.x)

AI Gateway terminology renamed from credits to wallet with USD display

N8
n8n-assistant
·Apr 14, 2026

AI Gateway now shows users their remaining balance as dollar amounts rather than abstract credit counts, with endpoints, services, and UI components updated to use wallet/budget/balance terminology.

The AI Gateway feature has undergone a terminology facelift. Backend API endpoints, service methods, frontend stores, and UI components all renamed "credits" to "wallet/budget/balance" terminology — from the /ai/gateway/wallet endpoint to balance and budget state variables in the frontend store.

Users will now see their remaining balance formatted as USD dollar amounts like "$1.53 / $2.00 remaining" instead of raw integer credit counts. The usage table column previously labeled "Credits" now displays "Cost (USD)" with proper dollar formatting.

This touches the CLI package (controllers, services, frontend service), the frontend package (stores, composables, API client, Vue components), API types, constants, and i18n strings across the monorepo — an end-to-end terminology migration.

View Original GitHub Description

Description

Backport of #28436 to release-candidate/2.17.x.

Checklist for the author (@DawidMyslak) to go through.

  • Review the backport changes
  • Fix possible conflicts
  • Merge to target branch

After this PR has been merged, it will be picked up in the next patch release for release track.

Original description

Summary

Renames "credits" terminology to "wallet/budget/balance" across the AI Gateway feature and switches display values from integer credit counts to USD dollar amounts ($X.XX).

What changed:

  • AI_GATEWAY_CREDITS constant → AI_GATEWAY_BUDGET (quota:aiGatewayBudget)
  • Backend: /ai/gateway/credits endpoint → /ai/gateway/wallet, service method getCreditsRemaining() → getWallet() returning { budget, balance }
  • Frontend: stores, composables, and components updated from creditsRemaining/creditsQuota to balance/budget, fetchCredits() → fetchWallet()
  • UI: all AI Gateway credit displays now show USD amounts ($1.53 / $2.00 remaining)
  • Usage table column renamed from "Credits" to "Cost (USD)" with $X.XX formatting
  • i18n strings updated to use balance/budget/wallet terminology

Related Linear tickets, Github issues, and Community forum posts

https://linear.app/n8n/issue/NODE-4834

Review / Merge checklist

  • I have seen this code, I have run this code, and I take responsibility for this code.
  • PR title and summary are descriptive. (conventions)
  • Docs updated or follow-up ticket created.
  • Tests included.
  • PR Labeled with Backport to Beta, Backport to Stable, or Backport to v1 (if the PR is an urgent fix that needs to be backported)
© 2026 · via Gitpulse