通用约定

请求格式

接口使用 HTTPS、UTF-8 JSON。GET 参数放在 Query，请求体为空；POST 参数放在 JSON 请求体，使用 Content-Type: application/json。只提交接口声明的参数，不允许重复字段。

响应格式

HTTP 状态固定为 200，根据 code 判断结果。

{
  "request_id": "7d5f6832c7494cb28e413f97f8460981",
  "code": 0,
  "message": "成功",
  "data": {}
}

字段	类型	说明
request_id	string	平台生成的请求追踪编号，与响应头 X-Request-Id 一致
code	integer	0 表示成功；1000 起为业务错误码
message	string	结果描述
data	object / array / string / null	业务数据，无数据时为 null

失败响应：

{
  "request_id": "7d5f6832c7494cb28e413f97f8460981",
  "code": 1005,
  "message": "签名验证失败",
  "data": null
}

金额与费率

数据	格式	示例
收款、退款、出款金额	正数金额字符串，最多 24 位整数和 2 位小数	"10.00"
手续费、到账金额	两位小数字符串	"0.63"、"9.37"
账户余额	最多 6 位小数字符串，省略末尾无意义的 0	"12.6"、"12.000006"
费率	0–10000 的基点整数字符串	"636" 表示 6.36%

手续费 = 收款金额 × 费率 ÷ 10000，直接舍弃第三位及之后的小数，不四舍五入。实际到账金额 = 收款金额 − 手续费。

ID 与时间

APPID、订单ID均为字符串。平台订单ID为 YYYYMMDD 加十位随机数字，表内唯一，随机部分允许以 0 开头；日期按北京时间生成。三方订单号在同一 APPID 下唯一，重复创建返回 1019。

时间采用 RFC 3339 / UTC，例如 2026-10-22T00:00:00Z；未发生的付款、关闭时间返回空字符串。

调用限制与重试

每个 APPID 的所有接口合计每自然分钟 60 次。1015 返回 Retry-After 秒数。每次重试重新生成时间戳、随机串和签名。创建订单超时后先查询原订单；申请退款超时后先查询退款，未查到时以原退款单号和原参数重试；申请出款超时后先查询出款，未查到时使用原三方订单号重试。