fix(clerk-js,types,localizations): Use "Payment methods" terminology (#5721)

panteliselef · web-flow · commit 2beea2957c67 · 2025-04-25T20:19:54.000+03:00
diff --git a/.changeset/small-berries-sneeze.md b/.changeset/small-berries-sneeze.md
@@ -0,0 +1,10 @@
+---
+'@clerk/localizations': patch
+'@clerk/clerk-js': patch
+'@clerk/types': patch
+---
+
+Switch to "Payment method" terminology instead of "Payment source".
+
+- Removes `userProfile.__experimental_billingPage.start.headerTitle__paymentSources`
+- Adds `userProfile.__experimental_billingPage.start.headerTitle__paymentMethods`
diff --git a/packages/clerk-js/src/ui/components/Checkout/CheckoutForm.tsx b/packages/clerk-js/src/ui/components/Checkout/CheckoutForm.tsx
@@ -163,7 +163,7 @@ const CheckoutFormElements = ({
             onOpenChange={setOpenAccountFundsDropDown}
           >
             {/* TODO(@Commerce): needs localization */}
-            <Disclosure.Trigger text='Payment Sources' />
+            <Disclosure.Trigger text='Payment Methods' />
             <Disclosure.Content>
               <Col gap={3}>
                 <PaymentSourceMethods
diff --git a/packages/clerk-js/src/ui/components/OrganizationProfile/OrganizationBillingPage.tsx b/packages/clerk-js/src/ui/components/OrganizationProfile/OrganizationBillingPage.tsx
@@ -26,7 +26,7 @@ import { SubscriptionsList } from '../Subscriptions';
 const orgTabMap = {
   0: 'plans',
   1: 'invoices',
-  2: 'payment-sources',
+  2: 'payment-methods',
 } as const;
 
 export const OrganizationBillingPage = withPlans(
@@ -75,7 +75,7 @@ export const OrganizationBillingPage = withPlans(
               />
               <Tab
                 localizationKey={localizationKeys(
-                  'userProfile.__experimental_billingPage.start.headerTitle__paymentSources',
+                  'userProfile.__experimental_billingPage.start.headerTitle__paymentMethods',
                 )}
               />
             </TabsList>
diff --git a/packages/clerk-js/src/ui/components/UserProfile/BillingPage.tsx b/packages/clerk-js/src/ui/components/UserProfile/BillingPage.tsx
@@ -26,7 +26,7 @@ import { SubscriptionsList } from '../Subscriptions';
 const tabMap = {
   0: 'plans',
   1: 'invoices',
-  2: 'payment-sources',
+  2: 'payment-methods',
 } as const;
 
 export const BillingPage = withPlans(
@@ -76,7 +76,7 @@ export const BillingPage = withPlans(
               />
               <Tab
                 localizationKey={localizationKeys(
-                  'userProfile.__experimental_billingPage.start.headerTitle__paymentSources',
+                  'userProfile.__experimental_billingPage.start.headerTitle__paymentMethods',
                 )}
               />
             </TabsList>
diff --git a/packages/localizations/src/ar-SA.ts b/packages/localizations/src/ar-SA.ts
@@ -707,7 +707,7 @@ export const arSA: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/be-BY.ts b/packages/localizations/src/be-BY.ts
@@ -715,7 +715,7 @@ export const beBY: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/bg-BG.ts b/packages/localizations/src/bg-BG.ts
@@ -706,7 +706,7 @@ export const bgBG: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/ca-ES.ts b/packages/localizations/src/ca-ES.ts
@@ -710,7 +710,7 @@ export const caES: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/cs-CZ.ts b/packages/localizations/src/cs-CZ.ts
@@ -706,7 +706,7 @@ export const csCZ: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/da-DK.ts b/packages/localizations/src/da-DK.ts
@@ -707,7 +707,7 @@ export const daDK: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/de-DE.ts b/packages/localizations/src/de-DE.ts
@@ -725,7 +725,7 @@ export const deDE: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: 'Rechnungen',
-        headerTitle__paymentSources: 'Zahlungsquellen',
+        headerTitle__paymentMethods: 'Zahlungsquellen',
         headerTitle__plans: 'Pläne',
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/el-GR.ts b/packages/localizations/src/el-GR.ts
@@ -715,7 +715,7 @@ export const elGR: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/en-GB.ts b/packages/localizations/src/en-GB.ts
@@ -715,7 +715,7 @@ export const enGB: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/en-US.ts b/packages/localizations/src/en-US.ts
@@ -689,8 +689,8 @@ export const enUS: LocalizationResource = {
       paymentSourcesSection: {
         actionLabel__default: 'Make default',
         actionLabel__remove: 'Remove',
-        add: 'Add new payment source',
-        addSubtitle: 'Add a new payment source to your account.',
+        add: 'Add new payment method',
+        addSubtitle: 'Add a new payment method to your account.',
         cancelButton: 'Cancel',
         formButtonPrimary__add: 'Add Payment Method',
         formButtonPrimary__pay: 'Pay {{amount}}',
@@ -699,13 +699,13 @@ export const enUS: LocalizationResource = {
           messageLine2:
             'You will no longer be able to use this payment source and any recurring subscriptions dependent on it will no longer work.',
           successMessage: '{{paymentSource}} has been removed from your account.',
-          title: 'Remove payment source',
+          title: 'Remove payment method',
         },
         title: 'Available options',
       },
       start: {
         headerTitle__invoices: 'Invoices',
-        headerTitle__paymentSources: 'Payment Sources',
+        headerTitle__paymentMethods: 'Payment Methods',
         headerTitle__plans: 'Plans',
         headerTitle__subscriptions: 'Subscriptions',
       },
diff --git a/packages/localizations/src/es-ES.ts b/packages/localizations/src/es-ES.ts
@@ -712,7 +712,7 @@ export const esES: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/es-MX.ts b/packages/localizations/src/es-MX.ts
@@ -713,7 +713,7 @@ export const esMX: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/fi-FI.ts b/packages/localizations/src/fi-FI.ts
@@ -710,7 +710,7 @@ export const fiFI: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/fr-FR.ts b/packages/localizations/src/fr-FR.ts
@@ -715,7 +715,7 @@ export const frFR: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/he-IL.ts b/packages/localizations/src/he-IL.ts
@@ -700,7 +700,7 @@ export const heIL: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/hr-HR.ts b/packages/localizations/src/hr-HR.ts
@@ -715,7 +715,7 @@ export const hrHR: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/hu-HU.ts b/packages/localizations/src/hu-HU.ts
@@ -711,7 +711,7 @@ export const huHU: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/id-ID.ts b/packages/localizations/src/id-ID.ts
@@ -719,7 +719,7 @@ export const idID: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/is-IS.ts b/packages/localizations/src/is-IS.ts
@@ -713,7 +713,7 @@ export const isIS: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/it-IT.ts b/packages/localizations/src/it-IT.ts
@@ -710,7 +710,7 @@ export const itIT: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/ja-JP.ts b/packages/localizations/src/ja-JP.ts
@@ -709,7 +709,7 @@ export const jaJP: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/ko-KR.ts b/packages/localizations/src/ko-KR.ts
@@ -703,7 +703,7 @@ export const koKR: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/mn-MN.ts b/packages/localizations/src/mn-MN.ts
@@ -710,7 +710,7 @@ export const mnMN: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/nb-NO.ts b/packages/localizations/src/nb-NO.ts
@@ -709,7 +709,7 @@ export const nbNO: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/nl-BE.ts b/packages/localizations/src/nl-BE.ts
@@ -708,7 +708,7 @@ export const nlBE: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/nl-NL.ts b/packages/localizations/src/nl-NL.ts
@@ -708,7 +708,7 @@ export const nlNL: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/pl-PL.ts b/packages/localizations/src/pl-PL.ts
@@ -718,7 +718,7 @@ export const plPL: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/pt-BR.ts b/packages/localizations/src/pt-BR.ts
@@ -714,7 +714,7 @@ export const ptBR: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/pt-PT.ts b/packages/localizations/src/pt-PT.ts
@@ -708,7 +708,7 @@ export const ptPT: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/ro-RO.ts b/packages/localizations/src/ro-RO.ts
@@ -713,7 +713,7 @@ export const roRO: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/ru-RU.ts b/packages/localizations/src/ru-RU.ts
@@ -723,7 +723,7 @@ export const ruRU: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/sk-SK.ts b/packages/localizations/src/sk-SK.ts
@@ -706,7 +706,7 @@ export const skSK: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/sr-RS.ts b/packages/localizations/src/sr-RS.ts
@@ -709,7 +709,7 @@ export const srRS: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/sv-SE.ts b/packages/localizations/src/sv-SE.ts
@@ -712,7 +712,7 @@ export const svSE: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/th-TH.ts b/packages/localizations/src/th-TH.ts
@@ -708,7 +708,7 @@ export const thTH: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/tr-TR.ts b/packages/localizations/src/tr-TR.ts
@@ -712,7 +712,7 @@ export const trTR: LocalizationResource = {
       },
       start: {
         headerTitle__invoices: undefined,
-        headerTitle__paymentSources: undefined,
+        headerTitle__paymentMethods: undefined,
         headerTitle__plans: undefined,
         headerTitle__subscriptions: undefined,
       },
diff --git a/packages/localizations/src/uk-UA.ts b/packages/localizations/src/uk-UA.ts
diff --git a/packages/localizations/src/vi-VN.ts b/packages/localizations/src/vi-VN.ts
diff --git a/packages/localizations/src/zh-CN.ts b/packages/localizations/src/zh-CN.ts
diff --git a/packages/localizations/src/zh-TW.ts b/packages/localizations/src/zh-TW.ts
diff --git a/packages/types/src/localization.ts b/packages/types/src/localization.ts

Original file line number	Diff line number	Diff line change
`@@ -163,7 +163,7 @@ const CheckoutFormElements = ({`
`163`	`163`	`onOpenChange={setOpenAccountFundsDropDown}`
`164`	`164`	`>`
`165`	`165`	`{/* TODO(@Commerce): needs localization */}`
`166`		`- <Disclosure.Trigger text='Payment Sources' />`
	`166`	`+ <Disclosure.Trigger text='Payment Methods' />`
`167`	`167`	`<Disclosure.Content>`
`168`	`168`	`<Col gap={3}>`
`169`	`169`	`<PaymentSourceMethods`