Create an intent
Declare an intent to spend before accessing card credentials.
Authorizations
API key authentication. Include your API key in the Authorization header as Bearer <api_key>.
Headers
Unique key for idempotent requests (24-hour cache)
Path Parameters
Card ID (e.g., card_...)
Body
Description of intended spend
Client-provided intent ID for idempotency
Expected amount in cents
Expected currency (e.g., usd)
Expected merchant name
Expected merchant category codes
Allowed amount tolerance in cents
Allowed amount tolerance as percentage
Intent time-to-live in minutes (max 1440)
Response
Intent created
Unique intent ID
Associated card ID
Description of intended spend
Intent status
pending_approval, pending, matched, mismatched, expired, rejected, canceled Client-provided intent ID for idempotency
Expected transaction amount in cents
Expected merchant category codes
Allowed amount tolerance in cents
Allowed amount tolerance as percentage
Intent expiration timestamp (ms)