Agent skill
agentpay
Give your AI agent a funded balance and single-use virtual cards to spend online. Handles init, funding, balance checks, and disposable card creation via a lean 6-endpoint API. Triggers on "agent needs to buy something", "purchase API credits", "agent spending", "virtual card", "agent payments".
Install this agent skill to your Project
npx add-skill https://github.com/steve-cooks/skills/tree/main/skills/agentpay
Metadata
Additional technical details for this skill
- tags
- payments, virtual-cards, agent-spending, api
- author
- Steve | https://x.com/steve_cook
- version
- 1.0.0
SKILL.md
AgentPay
Give your agent money. Single-use virtual cards that self-destruct after one use.
Base URL
https://agent-pay.sh
The Flow
POST /init → Create account, get API key (shown once — save it)
POST /fund → Get checkout link, hand to human to pay
GET /balance → Check available balance
POST /spend → Create single-use card for exact amount
CLI
npm install -g agentpay-cli
agentpay init # Create account, save API key locally
agentpay balance # Show available balance
agentpay fund <amount> # Create funding checkout link
agentpay spend <amount> # Create single-use virtual card
agentpay cards # List previous cards (redacted)
agentpay expiration [min] # Get or set default card expiry
The CLI stores your API key at ~/.agentpay/config.json. Use --json for machine-readable output.
Quick Start (API)
# 1. Create account
curl -s -X POST https://agent-pay.sh/init
# → {"api_key": "ap_live_..."} ← SAVE THIS
# 2. Fund (human pays the checkout link)
curl -s -X POST https://agent-pay.sh/fund \
-H "Authorization: Bearer $AGENTPAY_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 25.00}'
# → {"checkout_url": "https://whop.com/checkout/..."}
# 3. Check balance
curl -s https://agent-pay.sh/balance \
-H "Authorization: Bearer $AGENTPAY_KEY"
# → {"available_balance": "25.00", "currency": "USD"}
# 4. Spend — get a one-time virtual card
curl -s -X POST https://agent-pay.sh/spend \
-H "Authorization: Bearer $AGENTPAY_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 10.00, "memo": "openai api credits"}'
# → {"pan": "4111...", "cvv": "123", "exp": "12/26", ...}
# Card self-destructs after one use
Rules
- API key is returned once from
/init— save it immediately - Card details are returned once from
/spend— save them immediately - Cards are single-use and exact-amount — overspend is impossible
- Unused cards auto-refund balance on expiry (default 20 minutes)
GET /cardslists cards but never re-shows PAN/CVV
All Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /init |
Create account, receive API key |
| GET | /balance |
Check available balance |
| POST | /fund |
Generate checkout link for human funding |
| POST | /spend |
Create single-use virtual card |
| GET | /expiration |
Get default card expiry (minutes) |
| POST | /expiration |
Set default card expiry (1–1440 min) |
| GET | /cards |
List cards (redacted, no PAN/CVV) |
More
- Full docs:
https://agent-pay.sh/start - Machine-readable:
https://agent-pay.sh/llms.txt - CLI:
https://www.npmjs.com/package/agentpay-cli - Skill:
https://agent-pay.sh/skill
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
whop-dev
Build Next.js apps for the Whop platform. For empty repos, guides users from idea to deployed app through discovery and setup. For existing projects, provides best practices for authentication, payments, webhooks, and UI. Triggers on "build me a Whop app", @whop/sdk, verifyUserToken, checkAccess, checkout flows, webhook handling, Experience/Dashboard pages, Frosted UI. Delegates to companion skills (frontend-design, vercel-react-best-practices, supabase-postgres-best-practices, web-design-guidelines) for design, performance, and database.
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?