查询虚拟账户列表

GET
/openapi/v1/wallet/virtual-accounts

分页查询 MSO 的所有已开通虚拟账户。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

查询参数

masterAccountNo?string

主账户号(精确匹配)。长度 32

virtualAccountNo?string

虚拟账户号(精确匹配)。长度 32

accountHolderName?string

账户持有人名称(模糊搜索)。长度 128

currency?string

币种。长度 32

status?string

账户状态

可选值"ACTIVE""INACTIVE""CLOSED"
pageNum?integer

当前页码,默认 1

范围1 <= value
默认值1
pageSize?integer

每页记录数,默认 10,最大 1000

范围1 <= value <= 1000
默认值10

Header 参数

X-Channel-Provider?string

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

默认值"GLDB"

响应体

分页返回虚拟账户。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?
请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/wallet/virtual-accounts'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "a1b2c3d4-e5f6-7890",  "data": {    "total": 50,    "pages": 3,    "size": 20,    "current": 1,    "records": [      {        "virtualAccountNo": "1000000001",        "accountHolderName": "Example Trading Pte Ltd",        "masterAccountNo": "1000000000",        "currency": "SGD",        "status": "ACTIVE",        "contactName": "Example Contact",        "contactEmail": "contact@example.com",        "contactPhone": "+6500000000",        "bankReference": "REF-EXAMPLE-001",        "openedAt": "2025-12-02T10:15:20",        "createdAt": "2025-12-01T15:30:45",        "updatedAt": "2025-12-02T10:15:20"      }    ]  }}