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".

Stars 2
Forks 2

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

bash
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)

bash
# 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 /cards lists 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

Expand your agent's capabilities with these related and highly-rated skills.

steve-cooks/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.

2 2
Explore
mattpocock/skills

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.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

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.

111,310 9,758
Explore
mattpocock/skills

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.

111,310 9,758
Explore
mattpocock/skills

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.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results