Skip to main content
POST
Claim card session

Authorizations

Authorization
string
header
required

Bearer authentication: send your API key, agent key, or OAuth access token as Authorization: Bearer <credential>.

Headers

X-Instance-ID
string | null

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Maximum string length: 1024

Path Parameters

sessionId
string
required
Pattern: ^csn_[0-9a-f]{32}$

Query Parameters

customerPartyId
string

Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf.

Pattern: ^pty_[0-9a-f]{32}$

Response

Successful Response

sessionId
string
required
cardId
string
required
card
object
required
billingAddress
object | null
required

The card's billing address on file, for filling the merchant's checkout (the ZIP drives the bank's AVS check). Null for Natural-issued cards, which store none.

proxy
object
required
allowedHosts
string[]
required
expiresAt
string
required
Maximum string length: 64
instructions
string[]
required

Instructions for configuring and verifying the checkout proxy before paying.