四方支付代付接口文档

简介

作者	支付平台
版本	v1.0.0
host	https://api2.ceshi666.icu
接口格式	JSON 请求，JSON 响应
字符集	UTF-8

签名规则

签名算法	HMAC-SHA256
公共参数	`merchantNo`、`timestamp`、`nonce`、`sign`
签名字段	除 `sign` 外的非空字段按字段名 ASCII 升序拼接为 `k=v&k2=v2`，使用商户秘钥计算 HMAC-SHA256 十六进制小写签名。
时间戳	秒级时间戳，默认允许与服务器时间相差 5 分钟。
nonce	随机字符串，全局防重放。

代付下单接口

请求方式	POST
接口地址	`https://api2.ceshi666.icu/api/pay/payout/create`
Content-Type	`application/json`

请求参数

merchantNo	商务号，必填
merchantOrderNo	商户代付单号，必填，同一商户唯一
amount	代付金额，必填，单位元
currencyCode	币种，可选，例如 CNY
accountInfo	收款账号/银行卡号，必填
payeeName	收款人姓名，建议必填
channelId	指定通道 ID，可选
timestamp	秒级时间戳，必填
nonce	随机字符串，必填
sign	签名，必填

请求示例

{
  "merchantNo": "M000001",
  "merchantOrderNo": "P202605040001",
  "amount": 50.00,
  "currencyCode": "CNY",
  "accountInfo": "6222000000000000000",
  "payeeName": "张三",
  "timestamp": 1777891200,
  "nonce": "n202605040002",
  "sign": "签名值"
}

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "duplicate": false,
    "id": 20001,
    "platformOrderNo": "P17778912001234",
    "orderStatus": 1
  }
}

代付查询接口

请求方式	GET
接口地址	`https://api2.ceshi666.icu/api/pay/payout/query`
查询条件	`merchant_order_no` 与 `platform_order_no` 二选一