Cards

A card is a single-use virtual Visa your agent can use to make purchases. Each card you create is funded from your wallet balance 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). The amount is reserved from your wallet’s spending power.
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 returns any unspent funds to your wallet.

​

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. Test cards (from an organization’s sandbox integration) 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.
• Every card has a fixed spend limit, so a card can never draw more from your wallet than the amount it was created with.