update link-cli to add address and eligible_for_balance as response from user-info - #340
Merged
Merged
Conversation
sylwang-stripe
approved these changes
Sep 21, 2026
| Finite spend-limit values are cents because this response does not include a currency. A null limit or remaining amount means unlimited. The verification requirement's action_url is null when no action is available. | ||
| The address and `eligible_for_balance` fields are omitted when their enrichment | ||
| is unavailable. `address` is null and `eligible_for_balance` is false when the | ||
| user has no Person record. Finite spend-limit values are cents because this |
Contributor
There was a problem hiding this comment.
what is a "Person record"
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates Link CLI and both SDKs to support the
/userinfofields introduced by stripe-internal/mint#2599690:addressresponse fieldeligible_for_balancebooleanaddress: nullMotivation
This lets an agent determine whether a user is eligible to use their Link balance before beginning a payment flow. The agent can avoid attempting or presenting balance as an option
when it is unavailable.
Balance eligibility is currently determined from the user’s address. In particular, users located in New York are ineligible because New York is treated as a crypto financial-activity
regulated state. Users without sufficient address information or outside the currently supported geography may also be reported as ineligible.
Exposing both
eligible_for_balanceand the supporting address gives agents enough context to understand the result and choose an appropriate payment method up front.Behavior
When enrichment succeeds:
eligible_for_balance: truemeans the agent may consider Link balance for the payment.eligible_for_balance: falsemeans the agent should use another eligible payment method.addresscontains the address used for the eligibility determination.address: nullwitheligible_for_balance: falsemeans no Person record was available.When enrichment is disabled or fails, both fields are omitted. Agents should not interpret omitted eligibility as either eligible or ineligible.
Test plan
Coverage includes populated and nullable addresses, eligible and ineligible users, New York addresses, missing Person records, explicit
falsevalues, and omitted enrichment fields.