Cards

A card is a prepaid virtual Visa your agent can use to make purchases. Each card you create is funded by a hold on your saved payment method and only charged when the card is actually used.

​

Lifecycle

1. Create — You issue a card with a fixed spend limit (within your plan’s per-card cap). A hold is placed on your payment method.
2. Use — Your agent makes purchases with the card number, expiry, and CVV — manually, via autofill, or through the buy surface. Funds are captured only as transactions settle.
3. Close — Closing a card is permanent and releases any uncaptured held funds.

​

Properties

• Spend limit — A fixed cap set when you create the card; your agent can never spend more than this.
• Balance — The remaining amount as transactions settle. Check it with check_balance / agent-cards balance <id> without exposing the credentials.
• Status — OPEN while usable, CLOSED once closed.
• Credentials (PAN / CVV / expiry) — Revealed only on explicit request via get_card_details / agent-cards cards details <id>, which may require approval.

​

Limits

The maximum amount per card depends on your plan: See Plans to upgrade. Cards created in test mode don’t count toward your monthly quota.

​

Safety

• Card numbers and CVVs are never displayed unless you explicitly ask.
• Closing a card is always confirmed first.
• Switching from test to prod mode is confirmed first, since prod cards draw on your real payment method.