Skip to main content
POST
/
customers
/
api
/
manage
/
link-wallet
curl -X POST "https://api.trusset.org/customers/api/manage/link-wallet" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "referenceKey": "ref_a1b2c3d4e5f67890abcdef12345678",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd"
  }'

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "instanceId": "inst_xyz789",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "referenceKey": "ref_a1b2c3d4e5f67890abcdef12345678",
    "name": "Acme Corp",
    "country": "DE",
    "investorType": "PROFESSIONAL",
    "status": "pending",
    "archived": false,
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:05:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:05:00.000Z"
  }
}
Links an Ethereum wallet address to an existing customer that was created without a wallet. This is the second step of the deferred wallet flow: first create a customer without a walletAddress to receive a referenceKey, then call this endpoint when the end-customer connects their wallet in your application. The endpoint validates that the reference key exists, the customer does not already have a wallet, and the wallet is not already assigned to another customer in the same instance.

​
Request Body

​
referenceKey
string
required
The reference key returned when the customer was created without a wallet address. Format: ref_ followed by 32 hex characters.
​
walletAddress
string
required
Ethereum wallet address to link. Must be a valid checksummed or lowercased address.

​
Response Fields

​
success
boolean
Request status
​
data
object
The updated customer object with the linked wallet address
curl -X POST "https://api.trusset.org/customers/api/manage/link-wallet" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "referenceKey": "ref_a1b2c3d4e5f67890abcdef12345678",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd"
  }'

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "instanceId": "inst_xyz789",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "referenceKey": "ref_a1b2c3d4e5f67890abcdef12345678",
    "name": "Acme Corp",
    "country": "DE",
    "investorType": "PROFESSIONAL",
    "status": "pending",
    "archived": false,
    "createdAt": "2025-06-15T12:00:00.000Z",
    "updatedAt": "2025-06-15T12:05:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:05:00.000Z"
  }
}