四方支付代收接口文档

简介

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

签名规则

签名算法	MD5 小写
公共参数	`mchId`、`reqTime`、`sign`
签名字段	除 `sign` 外的非空字段按字段名 ASCII 升序拼接为 `k=v&k2=v2`，末尾追加 `&key=商户密钥` 后计算 MD5 小写。
请求时间	`reqTime` 为毫秒级时间戳，默认允许与服务器时间相差 5 分钟。
密钥	机器人或商户后台展示的“密钥”，不要参与请求明文字段，只用于生成签名。

代收下单接口

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

请求参数

mchId	商户号，必填
wayCode	支付方式/通道编码，可选；可传平台通道ID或通道编码，不传则系统自动路由
outTradeNo	商户订单号，必填，同一商户唯一
amount	订单金额，必填，单位分，例如 1000 表示 10.00 元
currencyCode	币种，可选，默认 CNY
notifyUrl	商户异步通知地址，必填
subject	商品标题，可选
body	商品描述，可选
clientIp	客户端IP，可选
reqTime	毫秒级时间戳，必填
sign	签名，必填

请求示例

{
  "mchId": "85798673",
  "wayCode": "2",
  "outTradeNo": "C202605040001",
  "amount": 1000,
  "currencyCode": "CNY",
  "notifyUrl": "https://merchant.example.com/pay/notify",
  "subject": "order",
  "body": "order",
  "clientIp": "127.0.0.1",
  "reqTime": 1777891200000,
  "sign": "签名值"
}

签名示例

amount=1000&body=order&clientIp=127.0.0.1¤cyCode=CNY&mchId=85798673¬ifyUrl=https://merchant.example.com/pay/notify&outTradeNo=C202605040001&reqTime=1777891200000&subject=order&wayCode=2&key=商户密钥
sign = md5(上述字符串).toLowerCase()

响应示例

{
  "code": 0,
  "message": null,
  "data": {
    "duplicate": false,
    "id": 10001,
    "platformOrderNo": "C17778912001234",
    "orderStatus": 0,
    "payUrl": null,
    "channelErrorMessage": null
  },
  "sign": "响应签名"
}

代收查询接口

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