link-balance

Installation
SKILL.md

Link balance

Link balance is a payment method that lets users hold money in their Link account. It can be used like any other payment method in link-cli, but it can also be used to make purchases without requesting approval.

In order to spend without approvals, the user must set up two things in Link: a balance and an approval policy.

  1. Link balance: The user must onboard to Link balance and fund their account.
  2. Approval policy: The user sets an approval policy for you. It sets an approval threshold: purchases below this amount don't need the user's approval.

The balance belongs to the user's Link account. The approval policy belongs to one agent's OAuth client, so an approval policy the user set for another agent does not apply to you.

Link balance is part of agent payments. It is unrelated to financial insights and to the bank balances from link-cli balances list. It needs no extra scopes or source actions. Neither Link balance nor an approval policy is part of the initial link-cli setup. Never assume they exist, and never block a normal approved payment on them.

Who can use it

Link CLI's built-in OAuth client is not currently eligible to set up Link balance, but it can use an existing balance with normal user approval.

Link balance is only available in the US, and not in New York State. Run link-cli user-info retrieve --format json and check eligible_for_balance to determine whether the user can onboard. It checks both user eligibility and whether your authenticated OAuth client can set up Link balance. Only suggest or direct the user to set up Link balance when eligible_for_balance is explicitly true. If it is false or missing, don't offer setup.

Installs
1.3K
Repository
stripe/link-cli
GitHub Stars
916
First Seen
4 days ago