Haoxuanxu/add list payment methods route

[haoxuanxu-stripe]

Summary

Add support for Link balance amounts returned by the payment-details list API.

• Parse and expose balance_details.available_balance in @stripe/link-sdk
• Display balance methods as Link balance $12.50 available
• Avoid rendering ****undefined when a payment method has no card or bank-account details
• Preserve balance methods when the available amount is unknown
• Align nullable payment-method fields with the API response
• Add a patch changeset for @stripe/link-cli and @stripe/link-sdk

Response example

{
  "id": "csmrpd_balance",
  "type": "BALANCE",
  "name": "Link balance",
  "is_default": false,
  "card_details": null,
  "bank_account_details": null,
  "balance_details": {
    "available_balance": {
      "amount": 1250,
      "currency": "usd"
    }
  }
}

CLI output:

csmrpd_balance Link balance $12.50 available

Motivation

The payment-details list can include a Link balance alongside cards and bank accounts. Previously, the SDK did not model its balance details and the interactive CLI assumed every
payment method had a last-four value, resulting in ****undefined.

Test plan

• SDK: 200 tests passed across 18 test files
• CLI: 579 tests passed across 45 test files
• Type checks passed
• SDK and CLI builds passed
• pnpm biome check . passed
• Added focused coverage for known and unavailable balance amounts

Rollout/revert plan

Client-only additive change with no migration required. Safe to revert.

[alwmh7792-del]

طيب ماتسعدني ع تفعيل في ‫خميس، 17 سبتمبر، 2026 في 10:50 م‬‏، كتب ‪haoxuanxu-stripe < ***@***.***>‬‏:

…

------------------------------ You can view, comment on, or merge this pull request online at: #343 Commit Summary - 5a7fb22 <5a7fb22> add command to link-cli - 37b861b <37b861b> add link-cli spending-policy retrieve route - 2f2e374 <2f2e374> add link-cli payment-methods list route File Changes (28 files <https://github.com/stripe/link-cli/pull/343/files>) - *A* .changeset/curvy-wombats-allow.md <https://github.com/stripe/link-cli/pull/343/files#diff-de4559695574e7e9f8c8c3d6b2e2031560c9813414fea13bf0c0e395018cb56c> (6) - *A* .changeset/lucky-pandas-balance.md <https://github.com/stripe/link-cli/pull/343/files#diff-babf550b3adb30a2010b2ff39832a521a05af2e7507dd493d0dc853b1aada9e5> (6) - *M* CLAUDE.md <https://github.com/stripe/link-cli/pull/343/files#diff-6ebdb617a8104a7756d0cf36578ab01103dc9f07e4dc6feb751296b9c402faf7> (2) - *M* README.md <https://github.com/stripe/link-cli/pull/343/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5> (22) - *M* packages/cli/src/__tests__/cli.test.ts <https://github.com/stripe/link-cli/pull/343/files#diff-39fb58bcfd561b9dd42946ecb638094dddb78b9f694f241f58ec8dd3e0b0f781> (66) - *M* packages/cli/src/cli.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-a41539444c74b5a2ba0684ecd0815fdf8463c8a617d5f01aee7b9ef230208d85> (8) - *M* packages/cli/src/commands/payment-methods/__tests__/payment-methods.test.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-ec17c5a54d2ecb57b9f877c9b9dd6654efa880076cc1ce784cb7078f694d6b65> (108) - *M* packages/cli/src/commands/payment-methods/index.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-bd7bffea588683963e0d3f10e93cfa7c3ce70b9fd52b7a7960dc96708f9136e0> (39) - *M* packages/cli/src/commands/payment-methods/list.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-0dd7f337aa6d2a7b07be2b5058585f25753798aeed359733af0f2e4df0e890d3> (10) - *A* packages/cli/src/commands/payment-methods/retrieve.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-d97d2cb91cfc347fdd38ee3db6f28c584502ab7024c43480c89009c0fa01ef98> (101) - *M* packages/cli/src/commands/payment-methods/schema.ts <https://github.com/stripe/link-cli/pull/343/files#diff-c77452e81b94a67e59c697445a129eb3c3bea383341d9808d3b78c2a3a30b19a> (7) - *A* packages/cli/src/commands/spending-policy/index.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-734d865a50fa1aaac05760884057484af6701bf647ac93f68d7693e6319111c5> (36) - *A* packages/cli/src/commands/spending-policy/retrieve.test.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-379a51c0a17530c7e354c23b11ec5675a3d41bee7cbdda3bad96c9403a09bfd6> (57) - *A* packages/cli/src/commands/spending-policy/retrieve.tsx <https://github.com/stripe/link-cli/pull/343/files#diff-72d0c36df85527731c0a768646cc855e70c543e763aec8eee6ee25839b8979cb> (83) - *M* packages/cli/src/utils/resource-factory.ts <https://github.com/stripe/link-cli/pull/343/files#diff-8669206c8d491159aff988ffe107422fa6a81974921a9adf02c9df3e304a3e3a> (12) - *M* packages/sdk-go/payment_methods.go <https://github.com/stripe/link-cli/pull/343/files#diff-97a63dac2defad9362a37a4b96180b2375252ca455c511016ca206b07413733f> (20) - *A* packages/sdk-go/payment_methods_test.go <https://github.com/stripe/link-cli/pull/343/files#diff-46f4426f66f516e2930fded5fd31cae7a542a3e14dabde2eaf720a1aa2882d81> (66) - *M* packages/sdk-go/types.go <https://github.com/stripe/link-cli/pull/343/files#diff-4a088e784465506334317507d4d65e9f0e8871e5b29927b2c58e341576e9c67c> (12) - *M* packages/sdk/README.md <https://github.com/stripe/link-cli/pull/343/files#diff-fb389a13c110d5b92cb85e2a1eb937b649ff8adc09a19626ab6cbc9218bb6d83> (6) - *M* packages/sdk/src/client.ts <https://github.com/stripe/link-cli/pull/343/files#diff-e69522078e000cc2cc8cab53f5e7c5c054ef8a093d56cad1e8ee3a2e4aaac9f8> (4) - *M* packages/sdk/src/index.ts <https://github.com/stripe/link-cli/pull/343/files#diff-7defdb66d87b1af98d5f3645f0da5fec53479a6f59a38af6fd2c9b619dd5f58c> (1) - *M* packages/sdk/src/resources/__tests__/payment-methods.test.ts <https://github.com/stripe/link-cli/pull/343/files#diff-9baf77db1a34f734e2ba5608c0bd1e8acc57387fc96813e260e07944e09be870> (100) - *A* packages/sdk/src/resources/__tests__/spending-policy.test.ts <https://github.com/stripe/link-cli/pull/343/files#diff-027f96add8ad284d405243c9cb46017b503e9470543cf2ad56ac1dce34c9cb25> (83) - *M* packages/sdk/src/resources/interfaces.ts <https://github.com/stripe/link-cli/pull/343/files#diff-3e4dae593c61a4d0c098d977a7920a4b18646bc7f3b6c29104bbd52b5598b927> (6) - *M* packages/sdk/src/resources/payment-methods.ts <https://github.com/stripe/link-cli/pull/343/files#diff-14790d49be1600dc559017d0cc98781af4b56df7e15aa712da407a2781fe0b1f> (51) - *A* packages/sdk/src/resources/spending-policy.ts <https://github.com/stripe/link-cli/pull/343/files#diff-8aee1bb7b2ecc176209b93b1219e99bd154fc8e3113c0797dd1d7aee51970845> (49) - *M* packages/sdk/src/types/index.ts <https://github.com/stripe/link-cli/pull/343/files#diff-3a008b63d0ff6ac582bbe2427783ad489e9a29da5249d496e47752c23641fbf4> (45) - *M* skills/create-payment-credential/SKILL.md <https://github.com/stripe/link-cli/pull/343/files#diff-90f34dadd171ce34f88559565a4d7d85f5e0292836e32394b9eb5642e1637fa2> (6) Patch Links: - https://github.com/stripe/link-cli/pull/343.patch - https://github.com/stripe/link-cli/pull/343.diff — Reply to this email directly, view it on GitHub <#343?email_source=notifications&email_token=CJ6YG7CQ6RTBRTWY7LUE5X35PQ573A5CNFSNUABEM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UF42DKNRSGM4DQMRQGGTHEZLBONXW5KTTOVRHGY3SNFRGKZFFMV3GK3TUVRTG633UMVZF6Y3MNFRWW>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/CJ6YG7DUEN6K3XEU7GBTYJT5PQ573AVCNFSNUABGKJSXA33TNF2G64TZHMYTEMJZGQZDINBYHE5US43TOVSTWNJUHEZDAMJXHA2TBILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/CJ6YG7BT5LGVHEBP2P5MSH35PQ573A5CNFSNUABEM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UF42DKNRSGM4DQMRQGGTHEZLBONXW5KTTOVRHGY3SNFRGKZFFMV3GK3TUVJTG633UMVZF62LPOM> and Android <https://github.com/notifications/mobile/android/CJ6YG7AO3Y5AQ7T7IXW5I3D5PQ573A5CNFSNUABEM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UF42DKNRSGM4DQMRQGGTHEZLBONXW5KTTOVRHGY3SNFRGKZFFMV3GK3TUVZTG633UMVZF6YLOMRZG62LE>. Download it today! You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>