商户
创建加密货币划转
在两个 VelaFi 商户托管钱包之间即时进行加密资产内部划转，无需支付链上 Gas 费。
POST
/
v2
/
assets
/
internalTransfer
创建加密货币划转
curl --request POST \
--url https://api-test.velafi.com/v2/assets/internalTransfer \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransfer"
payload = {
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
fromMerchantId: 123,
toMerchantId: 123,
tokenId: '<string>',
amount: 123,
clientId: '<string>'
})
};
fetch('https://api-test.velafi.com/v2/assets/internalTransfer', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/assets/internalTransfer")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"fromMerchantId\": 123,\n \"toMerchantId\": 123,\n \"tokenId\": \"<string>\",\n \"amount\": 123,\n \"clientId\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
}使用此端点将加密资产从一个商户的 VelaFi 托管钱包内部划转到另一个商户的钱包。内部划转即时结算，不产生区块链 Gas 费。发送方余额记录显示为负的
amount（借记），接收方余额记录显示为正的 amount（贷记）。提供 clientId 可实现幂等性——使用相同 clientId 的重复请求将返回原始结果，而不会创建第二笔划转。
所有请求都必须包含
X-BH-TOKEN 请求头和 Content-Type: application/json。端点
POST https://api.velafi.com/v2/assets/internalTransfer
请求参数
number
必填
发送加密货币的商户 ID。
number
必填
接收加密货币的商户 ID。
string
必填
要划转的代币符号。支持的值：
USDT、USDC、BTC、MMXN。number
必填
要划转的代币数量。
string
您为此次划转指定的唯一标识符，用于实现幂等性。
响应字段
number
HTTP 风格的响应码。
200 表示成功。string
可读的状态消息，例如
SUCCESS。object
示例
cURL
curl -X POST https://api.velafi.com/v2/assets/internalTransfer \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fromMerchantId": 246,
"toMerchantId": 61,
"tokenId": "USDT",
"amount": 10,
"clientId": "crypto-transfer-001"
}'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "4352",
"tokenId": "USDT",
"amount": "-10",
"clientId": "crypto-transfer-001",
"merchantId": "246",
"fromMerchantId": "246",
"toMerchantId": "61"
}
}
响应中的
amount 为负数，因为它表示发送方账户的借记。使用查询加密货币划转端点可查看划转双方的记录。⌘I
创建加密货币划转
curl --request POST \
--url https://api-test.velafi.com/v2/assets/internalTransfer \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransfer"
payload = {
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
fromMerchantId: 123,
toMerchantId: 123,
tokenId: '<string>',
amount: 123,
clientId: '<string>'
})
};
fetch('https://api-test.velafi.com/v2/assets/internalTransfer', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/assets/internalTransfer")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"fromMerchantId\": 123,\n \"toMerchantId\": 123,\n \"tokenId\": \"<string>\",\n \"amount\": 123,\n \"clientId\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
}