stripe-link-cli

Executes agent-initiated purchases through Stripe Link with user-approved virtual cards and shared payment tokens.

1|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/Lento47/arcana-community --skill stripe-link-cli-lento47
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stripe-link-cli
Source: https://github.com/Lento47/arcana-community/tree/main/skills/payments/stripe-link-cli
Command: npx skills add https://github.com/Lento47/arcana-community --skill stripe-link-cli-lento47

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @stripe/link-cli.

What problem does it solve? AI agents cannot complete purchases on a user's behalf without a secure payment credential and explicit human approval. This Skill wraps the @stripe/link-cli so an agent can authenticate with Stripe Link, create spend requests, and retrieve one-time-use virtual cards or Shared Payment Tokens — with every transaction gated by an in-app approval the agent cannot bypass. ## Core Features & Use Cases - Approval-gated spending: Every spend request pings the user's Link mobile/web app and blocks until the user approves or denies, so the agent can never self-approve a charge. - Two credential types: Issues one-time-use virtual cards for standard web checkout forms, or Shared Payment Tokens (SPT) for merchants returning HTTP 402 with method="stripe". - Secure credential handling: Card details are written to a 0600-permission file via --output-file so the PAN never enters the agent's transcript or logs. - Use Case: A user asks the agent to buy a $25 API subscription. The agent checks auth, lists payment methods, creates a spend request with line items, waits for the user's phone approval, retrieves the card to a temp file, completes checkout, and deletes the file. ## Quick Start Ask the agent to buy an item or pay for a service, for example: "Use Stripe Link to purchase a one-month subscription to this API for $20 and confirm with me before creating the spend request."

Frequently Asked Questions about stripe-link-cli

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

FAQPage Schema
How do I let an AI agent make purchases with Stripe Link?▼

Install @stripe/link-cli globally, authenticate with `link-cli auth login`, then create a spend request with `link-cli spend-request create --request-approval`. The user's Link app must approve each transaction before the agent can retrieve a one-time-use virtual card.

What is the difference between a virtual card and a Shared Payment Token in Stripe Link?▼

Virtual cards (`card` credential type) are for standard web checkout forms and Stripe Elements. Shared Payment Tokens are for merchants returning HTTP 402 with `method="stripe"` in the www-authenticate header, paid via `link-cli mpp pay`.

Can the agent approve its own spend requests?▼

No. Every spend request with `--request-approval` pings the user's Link mobile or web app and polls until the user approves or denies. The CLI exits non-zero on denial or timeout, and the agent cannot bypass this step.

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

No. The Link account requirement makes it US-only, and `auth login` will fail elsewhere. The upstream CLI does not support Windows, so this skill is gated to Linux and macOS platforms.

How are card details kept out of agent logs and transcripts?▼

Retrieve credentials with `link-cli spend-request retrieve --output-file /tmp/link-card.json`, which writes the card to a file with 0600 permissions. Stdout shows only redacted fields like brand and last4, and the file should be deleted after the purchase.

Why does a Stripe Link purchase fail silently at checkout?▼

The most common cause is choosing the wrong credential type for the merchant. Evaluate the merchant first: use `card` for standard checkout forms and `shared_payment_token` only for HTTP 402 responses with `method="stripe"` in the challenge header.