Register customer wallet
curl --request POST \
--url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"blockchain": "stellar"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
publicKey: 'GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL',
blockchain: 'stellar'
})
};
fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet"
payload = {
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"blockchain": "stellar"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"blockchain": "stellar",
"claimedOwnership": true,
"createdAt": "2026-05-01T14:30:00Z",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"updatedAt": "2026-05-02T09:15:00Z",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}Wallets
Register customer wallet
Registers a crypto wallet for a customer that belongs to the caller’s organization or a
direct child organization. Mirrors POST /ramp/wallet but scoped
to a specific customer within the caller’s org hierarchy.
This endpoint only accepts bring-your-own (external) wallets (publicKey + blockchain). Embedded-wallet provisioning is not supported for customer wallets. Use POST /ramp/wallet for the organization instead.
If the wallet was previously soft-deleted, it is restored. Optionally claims ownership of the wallet on behalf of the customer’s organization.
Idempotent: registering an already-active wallet returns the existing record.
POST
/
ramp
/
customer
/
{customer_id}
/
wallet
Register customer wallet
curl --request POST \
--url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"blockchain": "stellar"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
publicKey: 'GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL',
blockchain: 'stellar'
})
};
fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/wallet"
payload = {
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"blockchain": "stellar"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"blockchain": "stellar",
"claimedOwnership": true,
"createdAt": "2026-05-01T14:30:00Z",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"publicKey": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL",
"updatedAt": "2026-05-02T09:15:00Z",
"walletId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}Path Parameters
Body
application/json
Response
The registered wallet