stripe-link-cli

Completes merchant purchases via Stripe Link using one-time virtual cards and Shared Payment Tokens.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill stripe-link-cli-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stripe-link-cli
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/payments/stripe-link-cli
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill stripe-link-cli-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @stripe/link-cli.

What problem does it solve? It lets an agent pay for goods and paid APIs on the user's behalf through Stripe Link, while keeping every spend gated behind an explicit approval in the user's Link mobile or web app so the agent can never self-approve a charge. ## Core Features & Use Cases - One-time virtual cards: Creates spend requests that return single-use card credentials for standard web checkout forms and Stripe Elements. - Shared Payment Tokens (SPT): Handles merchants that respond with HTTP 402 and method="stripe" challenges via the MPP flow, decoding the raw WWW-Authenticate header and paying directly. - Approval-gated spending: Every purchase pings the Link app with --request-approval and blocks until the user approves or denies. - Secure credential handling: Retrieves card details with --output-file (0600 permissions) so the PAN never enters the agent's transcript or logs. - Use Case: A merchant API returns HTTP 402 for a paid endpoint. The skill decodes the challenge, creates a spend request, waits for the user's Link approval, and completes the payment with an SPT. ## Quick Start Ask the agent to buy an item or pay for an API call, for example: "Use Stripe Link to pay $12.99 for this checkout and ask me to approve it in the Link app."

Frequently Asked Questions about stripe-link-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a payment with Stripe Link from the command line?▼

Install @stripe/link-cli globally, authenticate with link-cli auth login, then create a spend request with link-cli spend-request create including the payment method ID, amount in cents, and --request-approval. The Link app prompts you to approve before any credential is issued.

How do I handle an HTTP 402 payment-required response from a merchant API?▼

Pass the raw WWW-Authenticate header to link-cli mpp decode to validate the challenge. If it specifies method="stripe", create a spend request with --credential-type shared_payment_token and pay via link-cli mpp pay. Challenges without method="stripe" are unsupported.

Does Stripe Link CLI work on Windows or outside the US?▼

No. The upstream link-cli does not support Windows, so this skill is gated to Linux and macOS. It is also US-only because a US-based Link account is required, and auth login will fail outside the US.

Can the agent approve a Stripe Link purchase by itself?▼

No. Every spend request is gated by an approval in the Link mobile or web app, and the CLI blocks with --request-approval until the user approves or denies. Running the CLI as an MCP server does not bypass this approval step.

How are card details kept secure when retrieved by the CLI?▼

Retrieve credentials with --output-file so the card file is written with 0600 permissions and stdout shows only redacted fields like brand and last4. The card file should never be read into agent context and should be deleted after the purchase completes.

What are the prerequisites for using Stripe Link payments?▼

You need Node.js 20+ on PATH and a US-based Link account. The Link account, payment method, and approval app are set up interactively during the first link-cli auth login and spend request, so no prior configuration or environment variables are required.