派付 API 总览

全站约定

请求格式

• 所有请求都通过 HTTPS 调用，不接受明文 HTTP。
• 写接口 (POST) 的 body 是 application/json; charset=utf-8，UTF-8 编码。
• 读接口 (GET) 用 query string；query 参数不参与签名。
• 必须带 4 个 HMAC header：X-Api-Key、X-Timestamp、X-Nonce、X-Signature。详见 鉴权章节。

响应格式

派付的所有响应都是 JSON，并统一按 CommonResult 封装：

// 成功（业务码 code = 0）
{
  "code": 0,
  "data": { ... },
  "msg":  ""
}

// 失败（HTTP 仍是 200，业务码 code != 0）
{
  "code": 1007002000,
  "data": null,
  "msg":  "签名校验失败：请检查 apiSecret 与待签字符串拼装顺序"
}

幂等

会产生副作用的接口都有业务幂等键：

• 创建充值地址：按 (应用, chainCode, externalUserId) 幂等，重复调返回已有地址。
• 发起提现：按 (应用, appOrderNo) 幂等，重复 appOrderNo 返回 1007004000 WITHDRAW_BUSINESS_DUPLICATE。

分页

列表接口走 pageNo（从 1 开始）+ pageSize，响应是 PageResult：

GET /api/v1/wallet/recharge/page?pageNo=1&pageSize=20

// 响应
{
  "code": 0,
  "data": {
    "list":  [ ... ],
    "total": 127
  },
  "msg": ""
}

pageSize 上限是 200，传更大值会被拒绝。

时间戳、金额与地址

• 签名用的 X-Timestamp 是 UNIX 毫秒（13 位整数）；响应里的业务时间字段是 ISO 形式的本地时间（如 "2026-05-05T12:34:56"）。
• 所有金额都是字符串形式的精确 decimal（如 "150.000000"），别用 number——浮点丢精度。
• 所有地址是各链原始大小写形式（EVM 走 EIP-55 校验和、TRON 走 Base58）。

错误码

业务码（code）是稳定常量，前 3 位 1-007 = 钱包平台。做错误分支时请按 code 判断，不要按 msg 文案。