支付引擎认证与签名

1. 请求参数中除去 sign 和空值参数外，其他参数按字典序排序. (定义：在英文字典中，排列单词的顺序是先按照第一个字母以升序排列; 如果第一个字母一样，比较后续字母。如果比到最后两个单词不一样长，短者排在前。)
2. 排序完成后，按照 key1value1key2value2... 进行拼接
3. 将项目的 API Key 拼接到上一步得到的字符串最前面
4. 将上一步中获取的字符串使用散列算法取 md5 并转为小写即为 sign，将 sign 添加到请求参数中

{
  "pid": 1382528827416576,
  "currency": "195@195",
  "address": "TXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FS",
  "amount": "1.1",
  "remark": "payout",
  "third_party_id": "c9231e604da54469a735af3f449c880f",
  "callback_url": "https://your-domain.com/callback",
  "nonce": "hwlkk6",
  "timestamp": 1688004243314
}

addressTXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FSamount1.1callback_urlhttps://your-domain.com/callbackcurrency195@195noncehwlkk6pid1382528827416576remarkpayoutthird_party_idc9231e604da54469a735af3f449c880ftimestamp1688004243314

f502a9ac9ca54327986f29c03b271491addressTXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FSamount1.1callback_urlhttps://your-domain.com/callbackcurrency195@195noncehwlkk6pid1382528827416576remarkpayoutthird_party_idc9231e604da54469a735af3f449c880ftimestamp1688004243314

• 仅在服务端保存和使用 API Key；不要放在前端代码、移动 App、网页源码、GitHub、日志或客服/运营可复制的页面中。
• 测试环境和生产环境使用不同的 Base URL、Project ID 和 API Key；不要跨项目或跨环境复用。
• 使用环境变量、密钥管理服务或服务器配置保存 API Key，并限制可读取该密钥的人员和服务。
• 启用并维护 IP 白名单，只允许受信任的服务器公网 IP 调用 API。
• 怀疑 API Key 泄露、误发或员工离职后，应及时检查近期订单、出款、回调和登录操作日志。
• 不要使用文档中的示例 API Key 或示例签名作为生产凭证。

• 系统参数: 大多数 API 请求都需要系统参数（回调通知除外）

• 业务参数: 特定于各个 API 调用或端点的参数

curl -X POST ${BASE_URL}/api/v1/payout \
  -H "Content-Type: application/json" \
  -d '{
    "pid": 1382528827416576,
    "nonce": "hwlkk6",
    "timestamp": 1688004243314,
    "sign": "f76fb193e9d34d2e59fef64e3418f79b",
    "currency": "195@195",
    "address": "TXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FS",
    "amount": "1.1",
    "remark": "payout",
    "third_party_id": "c9231e604da54469a735af3f449c880f",
    "callback_url": "https://your-domain.com/callback"
  }'

{
  "code": "00000",
  "msg": "ok",
  "data": {
    "cid": 1382813146816512
  }
}

{
  "code": "B0001",
  "msg": "签名错误",
  "data": []
}