Skip to main content
Creates a live virtual debit card. The card is funded by the saved payment method and charged for real when used, so call setup_payment_method first if none is saved, 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. Your payment method is only charged when the card is used, and the card 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 payment_method_required, kyc_required, user_info_required, or limit_reached.

​
Example

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