申请开通虚拟账户

POST
/openapi/v1/wallet/virtual-accounts

为 MSO(Money Service Operator)客户申请开通虚拟子账户。适用于支付机构为其下游商户开立独立的虚拟账户。

注意事项

  • 申请提交后需要银行审核,请通过查询接口跟踪申请状态
  • 申请成功后,虚拟账户号会在申请详情中返回

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

Header 参数

X-Channel-Provider?string

渠道提供商标识,如 GLDB。不传时默认 GLDB

默认值"GLDB"

请求体

multipart/form-data
  1. body
masterAccountNo?string

MSO 在渠道的主账户,为空则使用默认主账户。长度 32

accountName*string

MSO 的客户公司名称。长度 128

currency*string

支持多币种,多个币种用逗号分隔 (如 SGD,USD)。长度 32

contactName*string

紧急联系人姓名。长度 64

contactEmail*string

紧急联系人邮箱。长度 128

contactPhone*string

紧急联系人电话,E.164 格式 (如 +6591234567)。长度 32

companyRegistrationDoc*unknown

公司注册证明文件(如 COI)

accountOpeningProof?unknown

MSO 开户证明文件(如开户信),未传使用默认值

otherDocuments?array<unknown>

其他支持文件(如银行流水、身份证等)

响应体

返回申请单号和申请状态。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?
请求示例
curl -X POST 'https://api.test.stabofx.com/openapi/v1/wallet/virtual-accounts' \  -F 'accountName=Example Trading Pte Ltd' \  -F 'currency=SGD,USD' \  -F 'contactName=Example Contact' \  -F 'contactEmail=contact@example.com' \  -F 'contactPhone=+6500000000' \  -F 'companyRegistrationDoc=<binary file data>' \  -F 'otherDocuments=<binary file data>'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "6a3ae549-32dd-469a-a6b8-4e213c070930",  "data": {    "requestNo": "SA0000000001",    "status": "PENDING"  }}