POST
创建 Global Account
该接口用于为客户初始化 Global Account，并配置开户银行国家或地区以及支持收款的币种。
请求
apikeyOnerway 分配的账户服务 API key 请求 Header；必须使用与请求域名相同环境的值。
示例：
replace_with_account_service_apikeyrequestId请求 ID，用于幂等控制和链路追踪。
示例：
REQ-GA-20260423-0001customerId开通 Global Account 的客户标识。商户直接调用时，传入与
apikey 关联的客户标识；平台代子客户调用时，传入调用方有权限操作的子客户标识。示例：
801172onBehalfOf平台商户代子客户调用时传入的子客户标识。如传入，必须与
customerId 一致，且调用方必须具备该子客户的操作权限。示例：
456webhookUrl账户服务异步通知 URL，用于接收 Global Account 相关状态通知。
示例：
https://developers.onerway.com/example-account-webhook约束
- 规则
- 如传入，必须是合法 URL。
globalAccountNameGlobal Account 展示名称，用于账户信息展示和商户侧识别。
示例：
Acme USD Collection约束
- 规则
- 可使用字母、数字、空格、中文、下划线、点号或连字符。
curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v1/account/global/create' \
-H 'Content-Type: application/json' \
--data-raw '{
"requestId": "REQ-GA-20260423-0001",
"customerId": "801172",
"bankCountry": "US",
"supportCurrencies": [
"USD",
"EUR"
],
"webhookUrl": "https://merchant.example.com/hooks/account",
"globalAccountName": "Acme USD Collection"
}'响应
successGlobal Account 创建请求是否处理成功。当该值为
false 时，请读取 respCode 与 respMsg 判断失败原因，不要将 data 作为已创建账户结果使用。respCodeGlobal Account API 业务响应码；成功响应码为
20000。respMsg响应码对应的提示或错误说明。
data{ globalAccountId, onBehalfOf }创建后的 Global Account 信息。
error{ type, code, ... }账户服务返回的结构化错误信息。
{
"success": true,
"respCode": "20000",
"respMsg": "Success",
"data": {
"globalAccountId": "2002"
}
}该接口暂未记录错误响应。