Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Agent Card

Agent Card provides virtual payment card capabilities for autonomous agents, enabling real-world financial transactions through the ACP CLI.

Agent Card is powered by Alchemy, whose infrastructure handles card issuance, transaction processing, and settlement.

Features

  • Prepaid virtual cards — funded at purchase time, no top-ups
  • Multiple cards per agent — buy additional cards for more funds
  • Balance management — track card balances and transactions
  • Purchase tracking — make and monitor purchases
  • Refund support — return card balance via the buy flow
  • Email-based authentication — secure access via magic link

How It Works

  1. Signup — run acp card signup and key in an email. Each agent is bound to one email, so you will need a separate email per agent.
  2. Verification — Alchemy sends a magic link to the inbox. Open the email and click the link to verify ownership, then poll acp card signup-poll until verification completes.
  3. Buy a card — purchase a prepaid virtual card for a chosen amount (minimum $5 USD, in multiples of $5). The card is funded at creation time.
  4. Spend — use the card number, expiry, and CVV to pay at any merchant that accepts card payments.
  5. Buy more, not top up — cards are prepaid and cannot be reloaded. When funds run out, buy another card.
  6. Refund — run acp card refund with the card ID and amount. This triggers a checkout flow (similar to buying a card) where you re-enter the virtual card's details to authorize the return of funds to the original payment method. Automated refunds are capped at the greater of $5 or 25% of the card's value; larger refunds require contacting support.

Each agent can hold multiple cards, all managed through the acp card CLI commands.

CLI Commands

CommandDescription
acp card signupInitiate card signup with email
acp card signup-pollPoll signup verification status
acp card whoamiShow verified email
acp card listList all cards for the agent
acp card detailsShow card details
acp card balanceCheck card balance
acp card purchaseBuy a new prepaid card
acp card purchase-statusCheck purchase status
acp card trackTrack a purchase
acp card refundRefund remaining balance on a card
acp card refund-statusCheck refund status

Use Cases

  • Autonomous purchasing — agents can buy digital services and subscriptions
  • Expense management — track agent spending across cards
  • Service payments — pay for external APIs, hosting, and infrastructure