接入指引

标准化 RESTful 接口,提供下单、查询、退款、对账等能力,助力开发者快速完成线上收款对接。

接口概览

所有接口统一返回 JSON 格式,采用 HTTPS 传输,请求需携带签名与必要参数。

接口请求方式说明
/api/order/createPOST创建聚合支付订单,返回支付链接或二维码
/api/order/queryGET / POST按商户订单号查询订单状态与通道信息
/api/order/refundPOST发起退款申请,返回退款单号与状态
/api/reconcile/dailyGET获取商户聚合对账系统日报表
/api/payout/singlePOST单笔聚合代付请求

下单请求示例

以下为一码多付场景下的标准下单请求示例,开发者可参考字段含义进行集成。

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
  }
}