支付

获取支付方式

获取当前订单可用的支付方式列表（包含插件注册的第三方支付渠道）。

GET /api/pay/payWay

认证：需要

参数：

参数	类型	必填	说明
from	string	是	订单来源：order 商品订单 / recharge 充值
order_id	int	是	订单 ID

响应示例：

{
    "code": 1,
    "data": [
        {
            "pay_way": 1,
            "name": "余额支付",
            "icon": "",
            "extra": ""
        },
        {
            "pay_way": 2,
            "name": "微信支付",
            "icon": "",
            "extra": ""
        },
        {
            "pay_way": 100,
            "name": "杉德支付",
            "icon": "",
            "extra": "插件支付渠道"
        }
    ]
}

插件扩展

pay_way >= 100 的支付方式由插件通过 pay_channels 钩子注册，详见 插件系统。

---

预支付

发起支付请求，获取支付凭证。

POST /api/pay/prepay

认证：需要

参数：

参数	类型	必填	说明
from	string	是	订单来源
order_id	int	是	订单 ID
pay_way	int	是	支付方式编号
redirect	string	否	支付完成跳转地址

响应：根据不同支付方式返回不同的支付凭证（如微信 JSAPI 参数、支付宝表单、跳转 URL 等）。

---

查询支付状态

轮询订单支付结果。

GET /api/pay/payStatus

认证：需要

参数：

参数	类型	必填	说明
from	string	是	订单来源
order_id	int	是	订单 ID

响应字段：

字段	说明
pay_status	支付状态：0 未支付 / 1 已支付
pay_way	实际支付方式

---

微信小程序支付回调

POST /api/pay/notifyMnp

认证：不需要（微信服务器回调）

此接口由微信支付服务器调用，无需前端处理。

---

微信公众号支付回调

POST /api/pay/notifyOa

认证：不需要

---

支付宝支付回调

POST /api/pay/aliNotify

认证：不需要

---

插件支付回调

统一的插件支付回调入口，通过 channel 参数路由到对应插件处理。

POST /api/pay/pluginNotify

认证：不需要

参数：

参数	类型	必填	说明
channel	string	是	支付渠道标识（插件名）
其他参数			由第三方支付平台回调传入

插件开发

配置第三方支付回调地址时，设置为：https://你的域名/api/pay/pluginNotify?channel=插件名

系统会通过 pay_notify 钩子将回调分发到对应插件的处理方法，详见 插件系统。