商户
创建虚拟账户
在已激活的法币支付通道下为商户创建额外的虚拟子账户，以实现按别名路由资金。
POST
/
v2
/
merchant
/
virtual
/
accounts
创建虚拟账户
curl --request POST \
--url https://api-test.velafi.com/v2/merchant/virtual/accounts \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/merchant/virtual/accounts"
payload = {
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<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({merchantId: 123, fiat: '<string>', paymentId: 123, alias: '<string>'})
};
fetch('https://api-test.velafi.com/v2/merchant/virtual/accounts', 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/merchant/virtual/accounts")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantId\": 123,\n \"fiat\": \"<string>\",\n \"paymentId\": 123,\n \"alias\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"fiat": "<string>",
"status": 123
}
}使用此端点在已激活的法币支付通道下开设额外的虚拟账户。每个虚拟账户都会获得独立的银行凭证（例如专属的 CLABE 或 CVU），以便您按别名路由和对账资金。创建虚拟账户之前，相应的法币账户必须已处于激活状态。支持的币种为 MXN、ARS、BRL 和 COP。
所有请求都必须包含
X-BH-TOKEN 请求头和 Content-Type: application/json。alias 的值只能包含字母和数字。端点
POST https://api.velafi.com/v2/merchant/virtual/accounts
请求参数
number
必填
要为其创建虚拟账户的商户 ID。
string
必填
虚拟账户的法币币种。支持的值：
MXN、ARS、BRL、COP。number
必填
要使用的支付通道 ID。支持的对应关系：
72或105— MXN63— ARS68（Automatic ACH）或69（Bre-B）— COP90或92— BRL
string
必填
该虚拟账户的唯一别名，仅由字母和数字组成（最多 64 个字符）。对于 COP（
68、69），别名必须为 6 到 21 位大写字母或数字。default（不区分大小写）为保留字，不可使用。如果同一商户已存在 fiat、paymentId 和 alias 均相同的待处理或已激活虚拟账户，请求将被拒绝。响应字段
number
HTTP 风格的响应码。
200 表示成功。string
可读的状态消息，例如
SUCCESS。object
示例
cURL
curl -X POST https://api.velafi.com/v2/merchant/virtual/accounts \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"merchantId": 151209,
"fiat": "MXN",
"paymentId": 105,
"alias": "store001"
}'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"fiat": "MXN",
"status": 1
}
}
使用不同的别名，将虚拟账户映射到您平台内的各个用户、门店或成本中心。别名一经设定不可更改——如需使用不同的标识符，请创建新的虚拟账户。
⌘I
创建虚拟账户
curl --request POST \
--url https://api-test.velafi.com/v2/merchant/virtual/accounts \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/merchant/virtual/accounts"
payload = {
"merchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"alias": "<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({merchantId: 123, fiat: '<string>', paymentId: 123, alias: '<string>'})
};
fetch('https://api-test.velafi.com/v2/merchant/virtual/accounts', 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/merchant/virtual/accounts")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantId\": 123,\n \"fiat\": \"<string>\",\n \"paymentId\": 123,\n \"alias\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"fiat": "<string>",
"status": 123
}
}