账户服务接入准备
账户服务使用独立域名和 apikey 访问。开始调用账户余额、账户流水或 Global Account API 前，请先完成访问凭据和出口 IP 白名单配置。
请求域名
| Environment | Base URL |
|---|---|
Production | |
Sandbox |
环境切换
沙盒与生产环境需要分别使用对应域名和 apikey。接口路径、请求方法和请求结构保持一致。
访问凭据
账户服务通过 Header 中的 apikey 识别调用方权限。
| Header | Required | Description |
|---|---|---|
apikey | Yes | API key assigned for account service access. |
apikey 按环境区分，沙盒环境和生产环境不能混用。请不要把 apikey 暴露在前端页面、移动端应用或公开代码仓库中。建议由服务端保存并调用账户服务接口。
出口 IP 白名单
调用账户服务前，请向 Onerway 提供服务端出口 IP，用于配置访问白名单。
注意事项
- 仅提交稳定的服务端出口 IP。
- 如果生产环境和沙盒环境使用不同出口 IP，请分别提供。
- 如果出口 IP 发生变更，请在切换流量前更新白名单。
业务响应码
Global Account 接口使用 respCode 返回业务结果。常见响应码如下：
| respCode | Constant | Default respMsg |
|---|---|---|
20000 | SUCCESS_CODE | Success |
40001 | INVALID_PARAMETER | Invalid request parameter |
40002 | INVALID_TIME_RANGE | Invalid query time range |
40003 | UNAUTHORIZED_ACCESS | Access denied |
40004 | RESOURCE_NOT_FOUND | Resource not found |
40005 | REQUEST_FAILED | Request failed |
40006 | DUPLICATE_REQUEST | Duplicate request |
40007 | INIT_GLOBAL_ACCOUNT_FAILED | Init global account failed |
40008 | GLOBAL_ACCOUNT_CUSTOMER_INVALID | Invalid customer id for global account |
40009 | GLOBAL_ACCOUNT_CALLER_NOT_AUTHORIZED | Caller identity does not match customer |