Skip to main content
Manage virtual cards with the agent-cards cards command group. You need a saved payment method before creating your first card.

Create a card

Amounts are in US dollars, not cents:
agent-cards cards create --amount 25
OptionDescription
--amount <dollars>Required. Amount in dollars (e.g. 25 = $25.00).
-y, --yesSkip the confirmation prompt (for non-interactive / agent use).
--jsonOutput the result as JSON and run fully non-interactively.
The amount must be within your plan’s per-card cap (50Free/50 Free / 500 Basic / $1,000 Pro — see Plans). Your payment method is only charged when the card is actually used.

List cards

agent-cards cards list
Shows each card’s ID, last four digits, expiry, balance, and status.

Card details (PAN / CVV)

agent-cards cards details <card-id>
Returns the decrypted full card number, CVV, and expiry — use this to fill a payment form. Only run it when you actually need the credentials.

Balance

agent-cards balance <card-id>
A quick balance check without exposing the card credentials.

Transactions

agent-cards cards transactions <card-id>
OptionDescription
--limit <n>Number of transactions (default 20).
--status <status>Filter by status (e.g. PENDING, SETTLED, DECLINED, REVERSED, EXPIRED, REFUNDED).
agent-cards transactions <card-id> is a top-level alias for the same command.

Close a card

agent-cards cards close <card-id>
Closing is permanent and releases any held funds. Pass -y, --yes to skip the confirmation prompt.