查询开户选项

GET
/openapi/v1/fiat-accounts/opening-options

查询指定客户的可选开户路由与费用。currency 和 bankCountry 都可选,都不传时返回该客户的全部选项。partnerBanks 只是候选银行,实际开户银行以账户详情为准。仅适用于 LEGEND。GLDB 不支持,返回 openapi.channel.unsupported。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

查询参数

providerCustomerId*string

渠道侧客户标识,由调用方传入。Legend 即 user_short_id。

currency?string

ISO 4217 货币代码,长度 3。可选,不传则不按币种过滤。

bankCountry?string

ISO 3166-1 alpha-2 国家代码,长度 2。可选,不传则不按国家过滤。

Header 参数

X-Channel-Provider*string

渠道提供商标识,如 GLDB

响应体

返回开户选项列表。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?
请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/fiat-accounts/opening-options?providerCustomerId=usr_user123' \  -H 'X-Channel-Provider: GLDB'
响应示例
{  "code": 200,  "message": "操作成功",  "traceId": "t_xxxxxxxx",  "data": {    "options": [      {        "openingOptionId": "brt_abcdefghijklmnopqrstuvwxyz",        "currency": "SGD",        "bankCountry": "SG",        "partnerBanks": [          {            "bankCode": "DBS",            "bankName": "DBS Bank"          },          {            "bankCode": "SCB",            "bankName": "Standard Chartered Bank"          }        ],        "transferMethods": {          "deposit": [            "fast"          ],          "payout": [            "fast",            "swift"          ]        },        "feeSchedule": {          "accountOpenFee": "10.00",          "monthlyFee": "5.00",          "depositFee": {            "rate": "0.001",            "flat": "0.50",            "min": "1.00",            "max": "50.00"          },          "payoutFee": {            "rate": "0.001",            "flat": "0.50",            "min": "1.00"          }        },        "nameMatchRequired": true      }    ]  }}