Skip to main content
Creates a live virtual card. The card is funded from the wallet and charged for real when used — if the wallet balance is short, add funds with fund_wallet — and check get_plan for your per-card cap and monthly quota.
If your app connected with a sandbox OAuth client, this mints a test card instead — mock funds, no real charge, not usable at real merchants — for integration testing. A production client (which requires an active subscription) mints live cards. See Production.

​
Parameters

ParameterTypeRequiredDescription
amount_centsnumberYesCard funding amount in cents (minimum 100). The maximum depends on your plan: 50.00onFree,50.00 on Free, 500.00 on Basic. Call get_plan to check.

​
Returns

On success, status is created with the new card’s ID, last four digits, expiry, balance, and a billing address to use for online purchases. The card draws on the wallet balance when used, and it expires if not used within 7 days. The call can also pause with approval_required and an approvalId, which you resolve with approve_request after asking the user. Other statuses tell you what to fix first, such as wallet_funding_required, kyc_required, user_info_required, or limit_reached.

​
Example

{ "name": "create_card", "arguments": { "amount_cents": 2500 } }