Get a card
Authoritative card state. While the card is open it carries credentials (number, expiry, CVC) to key into the checkout. Each read of an open card notifies the member that the credentials were accessed, so fetch once when you are ready to pay rather than polling; poll flow status instead.
open card carries credentials (number,
expiry, CVC) to key into the checkout.
Every read of an open card notifies the member that its credentials were
accessed. Fetch once when you are ready to pay; for progress, poll
flow status instead. Never
persist the credentials.Authorizations
The user's connection access_token (user authentication), or an org-minted buy_token for org-owned accounts.
Path Parameters
Response
The card.
A one-time virtual card created against the member's added card.
"card"
Envelope status. open carries credentials; approval_pending carries approval_url.
approval_pending, open, in_use, paused, closed The attachment this card draws on.
"12/30"
Only while approval_pending: the page where the member approves this purchase with a passkey.
Only while approval_pending: when the approval window closes.
Only when closed: used, canceled, expired, or declined.
Only on an open card: the one-time credential to key into a checkout. Never persist it.
protected when the member requires an approval per reveal; retry when the credential read should be retried.

