ramp-agentic-purchase

Automates agent card purchases via browser checkout and completes Ramp transaction requirements.

2|1|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/ramp-public/skills --skill ramp-agentic-purchase-ramp-public
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ramp-agentic-purchase
Source: https://github.com/ramp-public/skills/tree/main/plugins/ramp/skills/ramp-agentic-purchase
Command: npx skills add https://github.com/ramp-public/skills --skill ramp-agentic-purchase-ramp-public

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @playwright/cli, and includes references (resource) components.

What problem does it solve? Making purchases with Ramp agent cards requires coordinating CLI credential retrieval, browser-based checkout, and post-purchase transaction compliance (memo, receipt, tracking categories, trip) — a multi-step process that is error-prone when done manually. ## Core Features & Use Cases - End-to-end purchase flow: Select an eligible agent card fund, generate single-use payment credentials via the ramp CLI, and complete merchant checkout through a playwright-cli-driven headed Chrome browser. - Transaction completion: After payment, automatically find the transaction and fill missing items — memo, tracking categories, trip assignment, and receipt upload (e.g., a screenshot of the confirmation page). - Safety guardrails: Enforces user preauthorization tolerance, Visa cryptogram amount caps, headed-browser-only operation, and human handoff for 3DS, CAPTCHAs, and login walls. - Use Case: Ask the agent to make a $45 donation to a charity; it picks the right fund, pulls fresh card credentials, fills the merchant's Stripe checkout form in a visible browser, then uploads the confirmation screenshot as the receipt and verifies no items are missing. ## Quick Start Use the ramp-agentic-purchase skill to buy a $45 donation at childrenshungerfund.org with my agent card and complete all missing transaction items.

Frequently Asked Questions about ramp-agentic-purchase

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

FAQPage Schema
How do I make a purchase with a Ramp agent card?

List funds with ramp agent_cards list, pick an eligible fund, generate single-use credentials with agent_cards creds, then fill the merchant checkout form in a headed Chrome browser via playwright-cli. After payment, complete missing transaction items like memo and receipt.

How do I enroll my business in Ramp Agent Cards?

Run ramp agent_cards enroll --agent with a rationale after getting explicit user confirmation, since enrollment is a mutation that activates Agent Cards for the business. The user must be authenticated via ramp auth login with appropriate permissions.

Why does my agent card payment get declined at checkout?

Declines happen when the final charge exceeds the cryptogram amount set in agent_cards creds, since the Visa cryptogram caps the charge at the network level. Pull fresh credentials at the corrected amount and re-preauth if it exceeds the user's 10% tolerance.

Can the browser checkout run in headless mode?

No, purchase flows must run headed so the user can see and intervene in bot checks, 3DS challenges, and login walls. Headless mode is only appropriate for unattended scraping with explicit user approval.

What happens when a CAPTCHA or 3DS challenge appears during checkout?

The agent stops, takes a screenshot, and hands off to the user to complete the challenge in the visible Chrome window. It waits for the user's reply before resuming, and never attempts a programmatic solve.

How do I complete missing receipt and memo requirements on a Ramp transaction?

Use ramp transactions missing to check gaps, then set the memo via transactions edit and upload a receipt with ramp receipts upload. A screenshot of the checkout confirmation page works as the receipt.