接口说明#
请求URL#
POST:{$base_url}/api/va/apply
请求参数#
| 参数名 | 参数描述 | 类型 | 约束 | 说明 |
|---|
| vaId | VA 编号 | String | C | 修改时必填,申请时系统返回。 |
| subMchNo | 子商户号 | String | M | |
| type | 收款类型 | String | M | B2C-电商收款,B2B-一般贸易收款,ST-服务贸易收款。 |
| areaCode | 地区编码 | String(2) | M | type=B2B/ST 时需填,默认 HK
B2B可选:HK,GB,US,TH,SG,CA,VN,PH,NG,ID,BR,DE
ST时仅 HK。 |
| currCode | 币种 | - | M | areaCode!=null 时必填,详见收款账户地区币种关系。 |
| fundsSourceCountry | 资金来源国家 | String(20) | M | type=B2B/ST 必填,国家编码(多个用“,”分隔)。 |
| shopId | 店铺 ID | String(32) | C | type=B2C 必填。 |
| attachments | 附件 | Array<File> | M | 支持格式:JPG, JPEG, PNG, PDF, ZIP,文件参数详见4.1.4 文件,类型详见4.2.2 子商户 VA 文件类型。 |
收款账户地区币种关系#
| VA TYPE | 地区 | 支持币种 | 账户币种 |
|---|
ST | HK | 多币种 | CNH,HKD,USD,EUR,GBP,SGD,JPY,AUD,CAD |
| B2B | HK | 多币种 | USD,HKD,CNH,EUR,GBP,AUD,CAD,JPY,SGD |
| B2B | HK | 单币种 | CNH |
| B2B | HK | 单币种 | HKD |
| B2B | HK | 单币种 | USD |
| B2B | HK | 单币种 | EUR |
| B2B | US | 单币种 | USD |
| B2B | GB | 单币种 | GBP |
| B2B | TH | 单币种 | THB |
| B2B | SG | 单币种 | SGD |
| B2B | CA | 单币种 | CAD |
| B2B | VN | 单币种 | VND |
| B2B | PH | 单币种 | PHP |
| B2B | NG | 单币种 | NGN |
| B2B | ID | 单币种 | IDR |
| B2B | BR | 单币种 | BRL |
| B2B | DE | 单币种 | EUR |
响应参数#
| 参数名 | 参数描述 | 类型 | 约束 | 说明 |
|---|
| vaId | VA编号 | String | M | |
请求示例#
{
"areaCode": "HK",
"attachments": [
{
"fileId": "37365d0b-4cfa-4fe2-96f1-0edbc8616316",
"fileType": "vaTransFile"
}
],
"currCode": "HKD",
"fundsSourceCountry": "HK",
"subMchNo": "2503060100000314",
"type": "ST"
}
响应示例#
{
"code": "0000",
"data": {
"vaId": "250307000002485701"
},
"error": false,
"msg": "操作成功",
"success": true
}