一、接口地址

用途	地址
代收提交	POST /api/payment/deposit
代收查询	POST /api/payment/info
代付提交	POST /api/charge/receive
代付查询	POST /api/charge/info
余额查询	POST /api/inquire/account/info

二、签名规则

1. 取所有请求参数（排除 sign 与空值），按参数名 ASCII 升序排列。
2. 拼接 key1=value1&key2=value2&...，末尾追加 &key=<secret_key>。
3. 对整串做 MD5、转小写，得到 sign。

⚠️ 金额固定两位小数（如 100.00）；value 做 URL-encode，空格编码为 %20（非 +）。

示例

参数：cus_code=MCH001, cus_order_sn=T20260917001, payment_flag=alipay_cny, amount=100.00
待签字串（ASCII 升序）：
amount=100.00&cus_code=MCH001&cus_order_sn=T20260917001&payment_flag=alipay_cny&key=你的密钥
sign = md5(上面整串) 转小写

三、代收下单 /api/payment/deposit

参数	必填	说明
cus_code	✓	商户号
cus_order_sn	✓	贵司订单号（唯一）
payment_flag	✓	alipay_cny（支付宝）
amount	✓	金额，两位小数字串（如 100.00）
notify_url	选	异步回调地址
redirect_url	选	付款完成跳转
payer_name	选	付款人姓名
sign	✓	见第二节

响应

{
  "result": 1, "status": "200", "message": "Success",
  "order_info": {
    "order_sn": "KF...",           // 我方订单号
    "cus_order_sn": "T20260917001",
    "currency_type": "CNY",
    "order_amount": "100.00",
    "payment_uri": "https://cashier.kf888.cash/pay/xxxx",  // 收银台，交付款人
    "order_status": "pending",
    "expired_at": "...", "created_at": "..."
  }
}

四、代付下单 /api/charge/receive

当前代付仅支持 支付宝（打款至指定支付宝账户）。

参数	必填	说明
cus_code / cus_order_sn / amount / sign	✓	同代收
payment_flag	✓	pay_alipay_cny
account_name	✓	收款人姓名（支付宝实名）
bank_account	✓	收款支付宝账号
notify_url / attach_data	选	回调地址 / 附加数据（原样回传）

五、查询接口

代收查询 /api/payment/info、代付查询 /api/charge/info、余额查询 /api/inquire/account/info。

查询参数：cus_code + order_sn（我方订单号）+ sign。

六、异步回调（notify_url）

我方以 POST 推送支付结果到贵司 notify_url（来源 IP 52.68.208.119）。验签方式与下单一致。贵司处理成功后须回传纯文本 success，否则我方会重试。

字段	说明
order_sn / cus_order_sn	我方 / 贵司订单号
currency_type	CNY
original_amount / order_amount	原始 / 订单金额（两位小数字串）
status	success / fail / 其他
message	结果说明
receive_amount / fee_amount	实际到账 / 手续费
account_name / bank_account	代付收款信息（代付回调）
attach_data	下单时的附加数据，原样回传
sign	验签用

七、订单状态

状态	说明
pending	待付款 / 处理中
success	成功（入账）
fail	失败
cancel	取消
expired	逾时未付款

八、对接流程

1. 贵司放行回调 IP 52.68.208.119、提供 notify_url。
2. 我方开通商户号，回传 cus_code + secret_key。
3. 先代收／代付各一笔小额测试单，确认回调与验签通过后上量。