API接入文档｜商户收款API与聚合代付接口

接入基础

接口地址、签名规则与请求格式说明。

请求基地址：https://demo-api.example.com/api

Content-Type：application/json

签名算法：参数按 key 升序拼接 + app_secret 后做 MD5。

重要提示：统一返回 code / msg / data 结构，便于快速集成与排错。

接口列表

创建订单 /orders/create

功能：商户调用创建一笔收款订单。

请求示例

POST /api/orders/create
{
  "merchant_id": "M2026001",
  "amount": 100.00,
  "channel": "code_pay",
  "notify_url": "https://your-domain.com/notify",
  "sign": "..."
}

返回示例

{
  "code": 0,
  "msg": "订单创建成功",
  "data": {
    "order_id": "D202610010001",
    "pay_url": "https://demo.example.com/pay/D202610010001",
    "status": "pending"
  }
}

查询订单 /orders/query

功能：查询订单支付状态。

GET /api/orders/query?order_id=D202610010001

{
  "code": 0,
  "data": {
    "order_id": "D202610010001",
    "amount": 100.00,
    "channel": "code_pay",
    "status": "paid"
  }
}

发起代付 /transfers/create

功能：发起一笔聚合代付请求。

POST /api/transfers/create
{
  "merchant_id": "M2026001",
  "amount": 50.00,
  "account": "6222****1234",
  "sign": "..."
}

对账下载 /reconcile/daily

功能：下载 T+1 对账文件。

GET /api/reconcile/daily?date=2026-10-01

返回 CSV 格式对账数据，包含通道流水、订单号、金额与状态。

SDK 代码示例

Node.js 快速发起一笔收款订单。

const axios = require('axios');
const crypto = require('crypto');

const params = { merchant_id: 'M2026001', amount: 100, channel: 'code_pay' };
const sign = crypto.createHash('md5')
  .update(Object.keys(params).sort().map(k => `${k}=${params[k]}`).join('&') + '&app_secret=DEMO_SECRET')
  .digest('hex');

axios.post('https://demo-api.example.com/api/orders/create', { ...params, sign })
  .then(res => console.log(res.data));

API 接入文档