Skip to main content
POST
Bind a card
This endpoint does not create an instruction and does not authorize spending. Use it when the user only needs to add a card. To bind a card and sign in one flow, omit payment_instrument_id in Create instruction instead. There are no body fields for choosing a customer; the session is always created for the token’s customer. Each call creates a new, independent session with a short TTL. When the user opens the link and completes the card-binding ceremony, the card is added to the customer’s payment methods (List payment methods). No instruction or authorization is created. The link can be reopened or re-exchanged while the session is still pending; it stops working once the card-binding ceremony completes or the session expires.
Treat the card-binding link as a credential. Do not forward it, screenshot it, or write it to logs; anyone who has the link can open it while it is valid and complete card binding for that customer. Deliver it only to the intended user.

Authorizations

Authorization
string
header
required

Portal user token from POST /agent/cwallet/platform/portal/tokens. Reads require portal:read; writes require portal:write.

Response

Success

code
integer<int32>

200 on success.

Example:

200

msg
string

Result message.

Example:

"Success"

data
object