Onerway
POST

查询 Global Account 详情

查看 Markdown
该接口用于读取 Global Account 详情、生命周期状态、支持的业务类型和支持收款的币种。

请求

apikeystring必填
Onerway 分配的账户服务 API key 请求 Header；必须使用与请求域名相同环境的值。
示例：replace_with_account_service_apikey
requestIdstring可选
请求 ID，用于链路追踪。
示例：REQ-GA-20260423-0002
globalAccountIdstring条件必填
条件：未传 globalAccountNo 时必填；如两个标识同时传入，必须指向同一个 Global Account。
数字格式的 Global Account ID，通常来自创建接口响应。
示例：1001
globalAccountNostring条件必填
条件：未传 globalAccountId 时必填；如两个标识同时传入，必须指向同一个 Global Account。
Global Account 账号，可作为查询账户详情的业务标识。
示例：GA-DEMO-0001
onBehalfOfstring可选
平台商户代子客户查询时传入的子客户标识。Global Account 必须属于该子客户，且调用方必须具备该子客户的操作权限。
示例：456

请求示例

curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v1/account/global/getDetail' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "requestId": "REQ-GA-20260423-0002",
  "globalAccountId": "1001"
}'

响应

successboolean
Global Account 详情查询是否处理成功。当该值为 false 时，请读取 respCode 与 respMsg 判断失败原因，不要将 data 作为账户详情使用。
respCodestring
Global Account API 业务响应码；成功响应码为 20000。
respMsgstring
响应码对应的提示或错误说明。
Global Account 详情。
账户服务返回的结构化错误信息。

响应示例

{
  "success": true,
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "globalAccountId": "1001",
    "globalAccountNo": "GA-DEMO-0001",
    "globalAccountName": "Acme USD Collection",
    "customerId": "CUS-EXAMPLE-001",
    "customerName": "Acme Ltd",
    "mainAccountNo": "MAIN-ACCOUNT-001",
    "mainAccountName": "Main Account",
    "iban": "GB29NWBK60161331926819",
    "bankCode": "NWBKGB2L",
    "swiftCode": "NWBKGB2LXXX",
    "bankAddress": "1 Example Street",
    "bankName": "Example Bank",
    "bankCountry": "GB",
    "bizTypeList": [
      "COBO",
      "POBO"
    ],
    "supportCurrencies": [
      "USD",
      "EUR"
    ],
    "institution": "Example Institution",
    "webhookUrl": "https://merchant.example.com/hooks/account",
    "operatingEntity": "Example Entity",
    "status": "Active",
    "globalActiveTime": "2026-04-23T06:31:18.266Z",
    "addressCity": "London",
    "addressPostalCode": "EC1A1BB"
  }
}
该接口暂未记录错误响应。

创建 Global Account

创建用于收单收款与资金转出场景的 Global Account（全球收付账户）。

查询账户余额变动流水

查询调用方商户账户或指定子商户账户的余额变动记录。