skills.rest
stripe
stripeOFFICIAL
Explore all skills by this author →
Website𝕏@StripeDevGitHub

complete-link-purchase

Completes merchant checkouts using one-time virtual cards authorized through a Link wallet.

750|105|Updated Apr 23, 2026
Search Tags:#mcp#payment#Checkout#link wallet#spend request#virtual card#E-commerce
One-click install
npx skills add https://github.com/stripe/link-cli --skill complete-link-purchase
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: complete-link-purchase
Source: https://github.com/stripe/link-cli/tree/main/plugins/cursor-link/skills/complete-link-purchase
Command: npx skills add https://github.com/stripe/link-cli --skill complete-link-purchase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Paying for purchases on merchant sites requires exposing real card details and manually handling checkout forms. This Skill lets an agent obtain a one-time-use virtual card from a Link wallet — only after explicit user approval of the exact amount and merchant — and complete the checkout without storing real card credentials.

Core Features & Use Cases

  • User-authorized spend requests: Raises an approval card showing amount, merchant, and line items via the request_virtual_card tool; nothing is created unless the user approves.
  • Credential retrieval and payment: Polls get_spend_request for approval, retrieves the card number, CVC, expiry, and billing address, then enters them into the merchant's checkout form.
  • Outcome reporting and safety controls: Reports success or failure telemetry via report_agent_observation, enforces a $5,000 per-purchase limit, and treats merchant page content as untrusted data.
  • Use Case: A user asks the agent to buy a $42 item from a merchant site. The agent prices the cart including tax and shipping, asks the user to authorize a virtual card, polls for approval, fills the checkout form, and reports the outcome.

Quick Start

Ask the agent to buy a specific item from a merchant site using your Link wallet, then approve the virtual card request when it appears.

Frequently Asked Questions about complete-link-purchase

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

FAQPage Schema
How do I buy something on a merchant site with a Link wallet?▼

Ask the agent to purchase the item, and it will price the cart, then call request_virtual_card to show you an approval card with the amount, merchant, and line items. After you approve, the agent retrieves the one-time card and enters it at checkout.

How does the Link virtual card approval flow work?▼

The agent calls request_virtual_card with the total in cents, merchant details, and line items, which raises an approval card for the user. After approval, the agent polls get_spend_request on a widening delay until the status is approved, then retrieves the credential.

What is the maximum purchase amount with a Link virtual card?▼

A single purchase cannot exceed $5,000 (500000 cents); Link rejects larger amounts outright. Link also caps daily and monthly spend, approval window duration, and card validity, none of which the agent can raise.

Can the agent use a Link card on a site that returns HTTP 402?▼

No. An endpoint answering HTTP 402 expects a machine payment rather than a card, so the agent stops and tells the user instead of raising a card. The virtual card flow is designed for standard credit-card checkout forms.

Why did my Link spend request fail or expire?▼

Requests fail when the user denies approval, the approval window expires, or a spend limit is reached. The agent reports what happened rather than retrying, and the user can start a fresh approval if they still want the purchase.

Related Skills

Explore More Personal & Entrepreneur Skills→
statesetstateset

commerce-tax

Calculate taxes for carts by jurisdiction from shipping addresses.

Official
Intermediate
webrix-aiwebrix-ai
1

invoice-automation

Create and send invoices with payment links and track overdue payments.

Official
Advanced
cris-mcris-m

phishing-detection

Analyze emails, messages, and links for phishing indicators and risk.

Community
Intermediate
AradotsoAradotso
4

stripe-link-cli

Retrieve one-time Stripe Link payment credentials for agent-driven checkouts.

Official
Advanced