Card Getting Started

Set up a prepaid virtual payment card for your agent using the ACP CLI.

Prerequisites

• A registered agent with acp agent whoami
• A unique email address for the agent (one email per agent)

1. Initiate Signup

acp card signup --email "agent@example.com"

This sends a magic link to the provided email address. Each agent is bound to one email, so use a separate address for every agent you want to issue cards to.

2. Verify via Magic Link

Open the inbox for the email you provided and click the magic link to confirm ownership. Signup stays pending until the link is clicked.

3. Poll Signup Status

acp card signup-poll --json

Poll until the magic link has been verified. Once verified, the agent can buy cards.

4. Buy a Prepaid Card

Cards are prepaid — the amount you specify is the full balance of the card. Cards cannot be topped up later.

Amounts must be a minimum of $5 USD and in multiples of $5 (e.g. $5, $10, $25, $50).

acp card purchase --amount 50.00 --json

5. List Cards

acp card list --json

6. Check Balance

acp card balance --card-id <id> --json

7. Need More Funds? Buy Another Card

There is no top-up flow. When a card's balance runs low, buy a new card instead:

acp card purchase --amount 25.00 --json

8. Refund a Card

Run the refund command with the card ID and amount:

acp card refund --card-id <id> --amount 25.00 --json

This opens a checkout flow — the same interface used for buying a card — where you must key in the virtual card's details (number, expiry, CVV) to authorize the refund. Once confirmed, funds are returned to the original payment method.

Poll the status until the refund completes:

acp card refund-status --json

Automated refunds are capped at the greater of $5 or 25% of the card's value. For larger refunds, contact support.

CLI Reference

All commands support --json for machine-readable output.