获取当前可用的收款方式列表（类别名称、金额范围）。无需传 Body 参数。

请求示例

POST /api/home/payList
Content-Type: application/json
x-api-key: 你的api_key

{}

Body 传空 JSON {} 即可。

成功返回

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "cate_name": "微信收款",        // 收款方式名称
      "min_amount": 10,               // 最小金额（元）
      "max_amount": 5000              // 最大金额（元）
    },
    {
      "id": 2,
      "cate_name": "支付宝收款",
      "min_amount": 10,
      "max_amount": 5000
    },
    {
      "id": 3,
      "cate_name": "银行卡收款",
      "min_amount": 100,
      "max_amount": 50000
    }
  ]
}

创建一笔收款订单，返回收款人信息（姓名、账号、二维码等），展示给用户去付款。

请求参数（JSON Body）

请求示例

POST /api/home/getPay
Content-Type: application/json
x-api-key: 你的api_key

{
  "pay_id": 1,
  "amount": 100.00,
  "order_no": "SHOP202405240001"
}

成功返回

{
  "code": 200,
  "msg": "success",
  "data": {
    "order_no": "CZ20240524120000AbCd1234",   // 平台订单号（重要：查单时用这个）
    "out_order_no": "SHOP202405240001",        // 商户订单号（原样返回）
    "amount": 100.00,
    "info": {
      "cate_name": "微信收款",                 // 收款方式名称
      "real_name": "张三",                     // 收款人姓名
      "nickname": "张三的店铺",                // 收款人昵称
      "qrcode": "https://xxx.com/qr.png",     // 收款二维码（图片URL）
      "account": "138****8888",                // 收款账号
      "phone": "138****8888"                   // 收款手机号
    },
    "expire_time": 1716570000,                 // 订单过期时间戳（秒）
    "expire_at": "2024-05-24 13:00:00",       // 订单过期时间（格式化）
    "expire_minutes": 10                       // 剩余有效分钟数
  }
}

根据平台订单号查询支付状态。适用于轮询场景，建议每 5-10秒 查询一次，status=1 时表示已收款。

请求参数（JSON Body）

请求示例

POST /api/home/queryOrder
Content-Type: application/json
x-api-key: 你的api_key

{
  "order_no": "CZ20240524120000AbCd1234"
}

成功返回

{
  "code": 200,
  "msg": "success",
  "data": {
    "out_order_no": "SHOP202405240001",          // 商户订单号
    "order_no": "CZ20240524120000AbCd1234",      // 平台订单号
    "amount": 100.00,
    "status": 1,                                  // 0=待支付  1=已收款  2=已过期
    "pay_time": 1716567890,                       // 收款时间戳（秒）
    "create_time": 1716567800                     // 创建时间戳（秒）
  }
}

轮询流程图

  ┌─────────┐    每5~10秒调一次    ┌──────────────┐
  │ 你的系统 │ ──────────────────→ │  queryOrder   │
  │         │                      │              │
  │         │ ←── status=0 ─────── │  还没付，继续等 │
  │         │ ←── status=1 ─────── │  已收款，停止轮询 │
  │         │ ←── status=2 ─────── │  已过期，停止轮询 │
  └─────────┘                      └──────────────┘

支付成功后，平台会主动向你的 callback_url 发送 POST 通知。 这是最实时的通知方式，强烈建议接入。

平台 POST 给你的数据（JSON）

{
  "merchant_no": "M2024001",              // 商户编号
  "out_order_no": "SHOP202405240001",     // 商户订单号
  "order_no": "CZ20240524120000AbCd1234", // 平台订单号
  "amount": "100.00",                     // 订单金额（字符串）
  "status": 1,                            // 1 = 已收款
  "pay_time": 1716567890,                 // 收款时间戳
  "nonce": "abc123def456",                // 随机字符串（防重放）
  "timestamp": "1716567890",              // 当前时间戳
  "sign": "A1B2C3D4E5F6..."              // 签名（验签用）
}

你收到回调后必须做的事：

示例：收到的参数为 { amount:"100.00", order_no:"CZ...", ... }

排序后拼接：
amount=100.00&merchant_no=M2024001&nonce=abc123&order_no=CZ...&out_order_no=SHOP001&pay_time=1716567890&status=1×tamp=1716567890&key=你的secret_key

MD5大写后就是你该收到的 sign 值，两者一致则验签通过。