接口概览
所有接口统一返回 JSON 格式,采用 HTTPS 传输,请求需携带签名与必要参数。
| 接口 | 请求方式 | 说明 |
|---|---|---|
| /api/order/create | POST | 创建聚合支付订单,返回支付链接或二维码 |
| /api/order/query | GET / POST | 按商户订单号查询订单状态与通道信息 |
| /api/order/refund | POST | 发起退款申请,返回退款单号与状态 |
| /api/reconcile/daily | GET | 获取商户聚合对账系统日报表 |
| /api/payout/single | POST | 单笔聚合代付请求 |
下单请求示例
以下为一码多付场景下的标准下单请求示例,开发者可参考字段含义进行集成。
POST /api/order/create HTTP/1.1
Host: api.your-domain.com
Content-Type: application/json
{
"mch_id": "MCH20260001",
"out_trade_no": "ORDER202610010001",
"amount": 100.00,
"channel": "auto",
"notify_url": "https://your-domain.com/callback",
"sign": "SHA256_WITH_RSA_SIGN"
}
响应示例
成功下单后返回支付链接、二维码地址与通道信息,失败时返回对应错误码。
{
"code": 0,
"message": "success",
"data": {
"trade_no": "PAY20261001000001",
"pay_url": "https://pay.your-domain.com/gateway/xxx",
"qr_url": "https://pay.your-domain.com/qr/xxx.png",
"channel": "码支付",
"expire_time": 300
}
}