> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt > Use this file to discover all available pages before exploring further. # agent-cards cards create > Fund and issue a new virtual card Fund and issue a new virtual card ```bash theme={null} agent-cards cards create --help ``` ```text theme={null} Usage: agent-cards cards create [options] Fund and issue a new virtual card Options: --amount Amount in US dollars, NOT cents (e.g. 25 = $25.00) --multi-use Create a multi-use card: stays open across charges until its limit is spent (subscriptions) --preset Restrict this card (see cards preset list). Adds limits only. Omit to use your account or app preset. (ai_labs implies --multi-use) --expires Auto-close the multi-use card at this ISO-8601 time (≤365 days out), e.g. 2027-01-01T00:00:00Z --from Where the money comes from: an added-card id (see add --list), or 'balance' to use your Agentcard balance even when a card is added -y, --yes Skip the confirmation prompt (for non-interactive / agent use) --json Output the result as JSON and run fully non-interactively --total Lifetime spend cap in US dollars --per-day Spend cap per rolling 24 hours, in US dollars --per-week Spend cap per rolling 7 days, in US dollars --per-month Spend cap per rolling 30 days, in US dollars --only-categories Restrict to categories (strict), comma-separated: meals, groceries, travel, software, ai, wellness, retail --watch-categories Categories in Watch mode (allow + notify on mismatch): meals, groceries, travel, software, ai, wellness, retail --only-merchants Restrict to merchant name patterns, comma-separated --only-in Restrict to places, comma-separated: a country (US, Canada), a region (europe, eu, north-america, apac), a US state (California, US-CA). A region expands to its countries; a state next to a region narrows only the US, e.g. north-america,US-CA --only-currencies Restrict to purchase currencies (strict), comma-separated ISO 4217 codes or names: usd,eur or dollars,euros,pounds,yen. Checked by Agentcard at checkout and settlement, not by the card network --watch-currencies Purchase currencies in Watch mode (allow + notify on mismatch), comma-separated: usd,eur. Checked by Agentcard, not by the card network --only-days Restrict to days, comma-separated: mon,tue or weekdays/weekends --only-hours Restrict to an hour range, e.g. 9-17 or 09:00-17:00 (24-hour; defaults to UTC without --timezone) --timezone IANA timezone for --only-days/--only-hours (default UTC), e.g. America/Los_Angeles --only-from Restrict to callers, comma-separated: cli, mcp, api, browser -h, --help display help for command ``` Pass `--preset ` to put a saved or built-in set of rules on the card, or spell the rules out with flags such as `--total`, `--per-day`, and `--only-categories`. Use one or the other; the command refuses both together. Pass neither and the card inherits your app default, then your account default. `--preset ai_labs` makes a multi-use card, and `--multi-use` beside it changes nothing. A multi-use card with a `Strict` category is refused with `strict_category_multi_use_unsupported`, because the card network cancels such a card after its first charge. Use a single-use card, or `--watch-categories`. The rules are explained in [Set rules on a card](/issuing/set-rules-on-a-card); the account and app defaults in [`cards preset`](/tools/cli/cards-preset). Say which currencies the card may pay in: ```bash theme={null} agent-cards cards create --amount 50 --only-currencies usd,eur -y ``` A charge in any other currency is refused, and you are told why. Write codes or plain names in any case, comma-separated: `usd,eur` or `dollars,euros`. If you would rather be told than refused, use `--watch-currencies` with the same list; pass one of the two, not both: ```bash theme={null} agent-cards cards create --amount 20 --watch-currencies usd --multi-use -y ``` Agentcard checks this rule at checkout and at settlement; the card network does not. Which names are refused as ambiguous, and what happens after the charge, are in [Choose the currencies](/issuing/set-rules-on-a-card#choose-the-currencies). The card shows the rule on its `Preset` line, and a `Network` line says who enforces it. Captured from a local sandbox: ```text theme={null} Card •••• 4277 Expires 09/28 Balance $20.00 ID cmttoum4z0003jpk0ugxz6bkx Preset Currency: USD, EUR. Network Agentcard enforces the currency rule at checkout and settlement; the card network does not ``` A refused create writes one line to stderr, the code first, and exits 1. Captured from a local sandbox: ```text theme={null} Error: strict_category_multi_use_unsupported: Multi-use cards with a strict category rule are not available yet: the card network closes a category-restricted card after its first approved charge. Create a single-use card, use Watch (--watch-categories) for a multi-use card, or drop the category rule. ``` If you write a name that means several currencies, the create is refused before any card is issued, and the message lists what it could mean. `agent-cards cards create --amount 20 --only-currencies pesos -y` answers: ```text theme={null} Error: policy_invalid: "pesos" could be MXN, ARS, CLP, COP, or PHP. Write the currency code, or name the country (Mexican pesos). ``` Inside the deprecation window a reusable `ai_labs` card is created and carries the notice: ```text theme={null} Multi-use card with preset Preset: ai_labs This card stays open across charges until its limit is spent — good for subscriptions. - Creating card... ✔ Virtual card issued! Card •••• 4454 Expires 09/28 Balance $40.00 ID cmtta6zne000ubrknm8imiu5n Preset Categories: Software, AI vendors. Rewarded merchants: OPENAI, CHATGPT, ANTHROPIC, CLAUDE, GEMINI, GOOGLE AI. Notice From 2026-10-08 a reusable card with a Strict category can no longer be created, this AI card included: the card network cancels such a card after its first approved charge. Cards already created keep working. For a reusable AI card after that date use --watch-categories software,ai (Watch); for a strict one, create a single-use card. Run: agent-cards cards details cmtta6zne000ubrknm8imiu5n # to see full PAN/CVV The card draws on your balance when used. It stays open until its limit is spent. Manage it with `agent-cards cards pause/resume`. ```