Skip to main content
POST
/
v1
/
wallet
/
internal
/
card_linked
Link Wallet to Card
curl --request POST \
  --url https://api.example.com/v1/wallet/internal/card_linked \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-client-key: <x-client-key>' \
  --data '
{
  "addressId": "<string>"
}
'
{
  "success": true
}
Link a custodial wallet to the card as a payment source. Each user can link up to 5 wallets.

​
Authentication

​
x-client-key
string
required
Your public API client key
​
Authorization
string
required
Bearer token for authentication

​
Request Body

​
addressId
string
required
Wallet addressId from GET /v1/wallet/internal response

​
Response

​
success
boolean
Whether linking was successful
{
  "success": true
}

curl -X POST "https://dev.api.baanx.com/v1/wallet/internal/card_linked" \
  -H "x-client-key: YOUR_CLIENT_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "addressId": "7c1839ee-918e-4787-b74f-deeb48ead58b"
  }'