List Card-Linked Wallets

curl --request GET \
  --url https://api.example.com/v1/wallet/internal/card_linked \
  --header 'Authorization: <authorization>' \
  --header 'x-client-key: <x-client-key>'

import requests

url = "https://api.example.com/v1/wallet/internal/card_linked"

headers = {
    "x-client-key": "<x-client-key>",
    "Authorization": "<authorization>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-client-key': '<x-client-key>', Authorization: '<authorization>'}
};

fetch('https://api.example.com/v1/wallet/internal/card_linked', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/wallet/internal/card_linked",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "x-client-key: <x-client-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/wallet/internal/card_linked"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-client-key", "<x-client-key>")
	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/v1/wallet/internal/card_linked")
  .header("x-client-key", "<x-client-key>")
  .header("Authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/wallet/internal/card_linked")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-client-key"] = '<x-client-key>'
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "1693a6da-5945-4461-ba1c-0b9891f78848",
    "address": "DfKNsYfrCEHb7ScJkuMTtPTeDiyjmBBm9NMHnbR7uFHz",
    "currency": "sol",
    "network": "solana",
    "priority": 1
  },
  {
    "id": "7c1839ee-918e-4787-b74f-deeb48ead58b",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb4",
    "currency": "usdc",
    "network": "ethereum",
    "priority": 2
  }
]

GET

wallet

internal

card_linked

List Card-Linked Wallets

curl --request GET \
  --url https://api.example.com/v1/wallet/internal/card_linked \
  --header 'Authorization: <authorization>' \
  --header 'x-client-key: <x-client-key>'

import requests

url = "https://api.example.com/v1/wallet/internal/card_linked"

headers = {
    "x-client-key": "<x-client-key>",
    "Authorization": "<authorization>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-client-key': '<x-client-key>', Authorization: '<authorization>'}
};

fetch('https://api.example.com/v1/wallet/internal/card_linked', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/wallet/internal/card_linked",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "x-client-key: <x-client-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/wallet/internal/card_linked"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-client-key", "<x-client-key>")
	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/v1/wallet/internal/card_linked")
  .header("x-client-key", "<x-client-key>")
  .header("Authorization", "<authorization>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/wallet/internal/card_linked")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-client-key"] = '<x-client-key>'
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "1693a6da-5945-4461-ba1c-0b9891f78848",
    "address": "DfKNsYfrCEHb7ScJkuMTtPTeDiyjmBBm9NMHnbR7uFHz",
    "currency": "sol",
    "network": "solana",
    "priority": 1
  },
  {
    "id": "7c1839ee-918e-4787-b74f-deeb48ead58b",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb4",
    "currency": "usdc",
    "network": "ethereum",
    "priority": 2
  }
]

Overview

Link internal (custodial) wallets to your card to use them as funding sources for card transactions. Users can link up to 5 wallets, with priority determining the order in which they are charged during purchases. Use Cases:

Enable card payments from specific wallets
Manage which currencies fund card transactions
Control payment source priority
Temporarily disable wallet usage for cards

Retrieve all custodial wallets currently linked to the user’s card.

Authentication

string

required

Your public API client key

string

required

Bearer token for authentication

Response

string

Linked wallet identifier

string

Wallet blockchain address

string

Currency code (e.g., “sol”, “usdc”)

string

Blockchain network (e.g., “solana”, “ethereum”)

number

Charging priority (lower numbers charged first)

[
  {
    "id": "1693a6da-5945-4461-ba1c-0b9891f78848",
    "address": "DfKNsYfrCEHb7ScJkuMTtPTeDiyjmBBm9NMHnbR7uFHz",
    "currency": "sol",
    "network": "solana",
    "priority": 1
  },
  {
    "id": "7c1839ee-918e-4787-b74f-deeb48ead58b",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb4",
    "currency": "usdc",
    "network": "ethereum",
    "priority": 2
  }
]

curl -X GET "https://dev.api.baanx.com/v1/wallet/internal/card_linked" \
  -H "x-client-key: YOUR_CLIENT_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

import requests

url = "https://dev.api.baanx.com/v1/wallet/internal/card_linked"
headers = {
    "x-client-key": "YOUR_CLIENT_KEY",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.get(url, headers=headers)
linked_wallets = response.json()

print(f"Linked wallets: {len(linked_wallets)}")
for wallet in sorted(linked_wallets, key=lambda w: w['priority']):
    print(f"{wallet['priority']}. {wallet['currency'].upper()} on {wallet['network']}")

interface LinkedWallet {
  id: string;
  address: string;
  currency: string;
  network: string;
  priority: number;
}

async function getLinkedWallets(): Promise<LinkedWallet[]> {
  const response = await fetch(
    'https://dev.api.baanx.com/v1/wallet/internal/card_linked',
    {
      headers: {
        'x-client-key': 'YOUR_CLIENT_KEY',
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
      }
    }
  );

  return await response.json();
}

Important Notes

Maximum Limit: Users can link up to 5 wallets to their card.

Priority Management: Use the Update Linked Wallets Priority endpoint to control which wallet is charged first.

Link Wallet to Card - Add a wallet as a card payment source
Unlink Wallet from Card - Remove a wallet from card payment sources
Update Linked Wallet Priority - Change charging order
Get Internal Wallets - View all available wallets

Overview

Authentication

User

Card

Orders

Wallet

Delegation

Consent

Referral

Webhooks

List Card-Linked Wallets

Overview

Authentication

Response

Important Notes

​Overview

​Authentication

​Response

​Important Notes

​Related Endpoints

Overview

Authentication

Response

Important Notes

Related Endpoints