create_card

sh.agentcard/agentcard · Verify this server

The one card tool: get the user a virtual debit card for a purchase. Cards are live and charged for real when used. For a FIRST-TIME user it starts by ADDING the user's OWN Visa or Mastercard — no identity verification (KYC) and no balance funding: the call returns a secure link (attach_started); send it to the user (about a minute: a one-time code from their bank plus a passkey), then call create_card again with the SAME arguments and it mints against the added card. If the user's card cannot be added (issuing_suggested), offer the fallback — an Agentcard funded from their cash balance, which requires KYC the first time — and only after the user agrees, call create_card with source "issued". Established users: the saved default decides (get_settings default_payment — their chosen added card, or the wallet balance); with no saved default, an active ADDED card wins, otherwise the cash balance. Per-call overrides: connected_card_id issues against a specific added card, source "issued" forces the cash balance, restart_setup starts a fresh add-card link. If the balance is short on the issued path, top up with add_funds. Connections through a company OAuth client have NO card count or amount limits; only first-party personal accounts have per-plan caps. Call get_plan for the limits in effect.