晓风聚合支付系统首页接口文档

# 晓风聚合支付系统首页接口文档

一、公开接口列表

二、网站元数据接口

接口路径：/api/meta/site
请求方式：GET
认证要求：无需认证，公开接口

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "cashier_templates": [
      {"code": "template1", "name": "简洁风格"},
      {"code": "template2", "name": "标准风格"}
    ],
    "home_pay_types": "alipay,wxpay,usdt,qqpay",
    "monitor_download_android_url": "https://cyjl.ljwx.site/...",
    "site_name": "晓风聚合支付系统",
    "site_logo": "/uploads/site/logo_1775839580321427391.png",
    "system_pay_pid": "M20260411c37ad0d84a"
  }
}

字段说明

三、用户认证状态接口

接口路径：/api/auth/me
请求方式：GET
认证要求：无需认证，公开接口

响应格式（已登录）

{
  "code": 0,
  "msg": "ok",
  "data": {
    "role": "merchant",
    "user_id": 2,
    "username": "m_0e23d3b4bf"
  }
}

响应格式（未登录）

{
  "code": 0,
  "msg": "ok",
  "data": null
}

字段说明

四、弹窗公告接口

接口路径：/api/meta/announcements?ann_type=site_popup
请求方式：GET
认证要求：无需认证，公开接口

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "list": [
      {
        "id": 1,
        "ann_type": "site_popup",
        "title": "晓风聚合支付系统",
        "content": "晓风聚合支付系统，基于 Go 语言纯自主研发...",
        "is_enabled": 1,
        "created_at": "2026-04-11 06:58:25",
        "updated_at": "2026-05-15 17:12:07"
      }
    ]
  }
}

字段说明

五、普通公告接口

接口路径：/api/meta/announcements?ann_type=normal
请求方式：GET
认证要求：无需认证，公开接口

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "list": [
      {
        "id": 5,
        "ann_type": "normal",
        "title": "严禁违规业务",
        "content": "本支付系统严禁违规业务...",
        "is_enabled": 1,
        "created_at": "2026-04-11 07:01:48",
        "updated_at": "2026-04-11 07:01:48"
      }
    ]
  }
}

字段说明

六、登录验证码接口

接口路径：/api/auth/login-captcha
请求方式：GET
认证要求：无需认证，公开接口

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "captcha_id": "63a0bd8fdb3b27d7",
    "captcha_svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" ...>",
    "prompt": "请按顺序点击：石 → 树 → 火"
  }
}

字段说明

七、发送邮箱验证码接口

接口路径：/api/auth/email-code
请求方式：POST
认证要求：无需认证，公开接口

请求格式

{
  "email": "test@example.com",
  "purpose": "register"
}

字段说明

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": null
}

八、用户登录接口

接口路径：/api/auth/login
请求方式：POST
认证要求：无需认证，公开接口

请求格式

{
  "email": "3295564195@qq.com",
  "password": "123456",
  "captcha_id": "3e702cf04dc14487",
  "captcha_points": [[100, 50], [150, 75], [200, 100]]
}

字段说明

响应格式（成功）

{
  "code": 0,
  "msg": "ok",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user_id": 2,
    "username": "m_0e23d3b4bf",
    "role": "merchant"
  }
}

响应格式（失败）

{
  "code": 1,
  "msg": "验证码错误",
  "data": null
}

字段说明

九、用户注册接口

接口路径：/api/auth/merchant/register
请求方式：POST
认证要求：无需认证，公开接口

请求格式

{
  "username": "",
  "password": "test123456",
  "email": "newtestuser@example.com",
  "email_code": "123456",
  "mobile": ""
}

字段说明

响应格式（成功）

{
  "code": 0,
  "msg": "ok",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user_id": 3,
    "username": "newtestuser",
    "role": "merchant"
  }
}

响应格式（失败）

{
  "code": 1,
  "msg": "邮箱验证码错误或已过期",
  "data": null
}

字段说明

十、创建测试订单接口（首页测试支付）

接口路径：/api/pay/public-test
请求方式：POST
认证要求：无需认证，公开接口

请求格式

{
  "pay_type": "alipay",
  "amount": 1
}

字段说明

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "trade_no": "T202605181901479191997b",
    "cashier_url": "/cashier/T202605181901479191997b",
    "channel": "alipay",
    "amount": 1.06
  }
}

字段说明

使用流程

1. 前端调用此接口创建测试订单
2. 获取返回的 cashier_url
3. 跳转到收银台页面

十一、收银台详情接口

接口路径：/api/pay/cashier/{trade_no}
请求方式：GET
认证要求：无需认证，公开接口

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "trade_no": "T202605181855419a3a67da",
    "out_trade_no": "PUBT1779101741189",
    "amount": 1.02,
    "subject": "首页测试支付",
    "qrcode_url": "https://qr.alipay.com/bax02997ybchsc0eqaer254c",
    "pay_url": "https://qr.alipay.com/bax02997ybchsc0eqaer254c",
    "status": 0,
    "expire_at": "2026-05-18 19:00:41",
    "channel_code": "alipay_face",
    "channel_id": 3,
    "cashier_template": "template2"
  }
}

字段说明

十二、查询支付结果接口

接口路径：/api/pay/result?trade_no={trade_no}
请求方式：GET
认证要求：无需认证，公开接口

响应格式

{
  "code": 0,
  "msg": "ok",
  "data": {
    "trade_no": "T202605181901037e5c56e8",
    "out_trade_no": "PUBT1779102063401",
    "amount": 1.05,
    "original_amount": 1,
    "notify_money": 1,
    "notify_status": 0,
    "status": 0,
    "return_redirect_url": ""
  }
}

字段说明

状态说明

十三、商户侧接口（需商户认证）

12.1 挂机心跳接口

接口路径：/api/merchant/channels/heartbeat
请求方式：POST
认证要求：需要签名认证

签名规则：sign = MD5(key + pid + join(sorted(channel_ids), ",") + timestamp)

请求格式：

{
  "pid": "10001",
  "channel_ids": [12, 18, 25],
  "client": "wechat_app_android",
  "timestamp": 1712475600,
  "sign": "md5(...)"
}

12.2 APP/PC 支付回调接口

接口路径：/api/pay/app/callback
请求方式：POST
认证要求：需要签名认证

签名规则：sign = MD5(key + pid + channel_id + amount + timestamp)

请求格式：

{
  "pid": "10001",
  "channel_id": 12,
  "amount": 10.00,
  "timestamp": 1712475600,
  "sign": "md5(...)"
}

12.3 页面跳转支付接口

接口路径：/submit.php
请求方式：POST
认证要求：无需认证

请求参数：

12.4 API返回支付信息接口

接口路径：/mapi.php
请求方式：POST
认证要求：无需认证

请求参数：

响应格式：

{
  "code": 0,
  "msg": "ok",
  "data": {
    "trade_no": "T202604111234567890",
    "qrcode": "https://qr.alipay.com/xxx",
    "pay_url": "https://qr.alipay.com/xxx",
    "amount": 10.00,
    "expire_at": "2026-04-11 12:00:00"
  }
}

12.5 订单查询接口

接口路径：/api.php?act=query
请求方式：GET
认证要求：无需认证

请求参数：

响应格式：

{
  "code": 0,
  "msg": "ok",
  "data": {
    "trade_no": "T202604111234567890",
    "out_trade_no": "ORDER123456",
    "status": 1,
    "amount": 10.00,
    "channel": "alipay",
    "created_at": "2026-04-11 10:00:00",
    "pay_time": "2026-04-11 10:05:00"
  }
}

状态说明：

12.6 异步通知接口（Webhook）

当支付完成后，平台会向商户的 notify_url 发送POST请求通知商户。

请求方式：POST
认证要求：根据商户配置的密钥进行签名验证

请求格式：

{
  "trade_no": "T202604111234567890",
  "out_trade_no": "ORDER123456",
  "status": 1,
  "amount": 10.00,
  "channel": "alipay",
  "pay_time": "2026-04-11 10:05:00",
  "sign": "md5(...)"
}

字段说明：

响应要求：商户收到通知后返回 "success" 表示成功接收。

技术变更记录

文档版本：v1.4
最后更新：2026-05-18