zhibo/模块文档/09-支付集成模块.md

支付集成模块接口文档

模块概述

支付集成模块提供金币充值、订单创建、支付处理等功能。

---

接口列表

1. 获取充值选项列表

接口路径: GET /api/front/gift/recharge/options

请求参数: 无

返回参数:

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": "选项ID",
      "coinAmount": 金币数量,
      "price": 价格,
      "discountLabel": "优惠标签"
    }
  ]
}

---

2. 创建充值订单

接口路径: POST /api/front/gift/recharge/create

请求头:

Authorization: Bearer {token}

请求参数:

{
  "optionId": "选项ID",
  "coinAmount": 金币数量,
  "price": 价格
}

返回参数:

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "订单ID",
    "paymentUrl": "支付URL"
  }
}

---

3. 订单支付

接口路径: POST /api/front/pay/payment

请求头:

Authorization: Bearer {token}

请求参数:

{
  "orderNo": "订单号",
  "payType": "支付类型",
  "payChannel": "支付渠道",
  "from": "android"
}

payType说明:

• alipay: 支付宝支付
• weixin: 微信支付
• yue: 余额支付

payChannel说明:

• appAliPay: 支付宝APP支付
• weixinAppAndroid: 微信APP支付(Android)
• yue: 余额支付

返回参数:

{
  "code": 200,
  "msg": "success",
  "data": {
    "status": true,
    "payType": "支付类型",
    "orderNo": "订单号",
    "jsConfig": {
      "appId": "应用ID",
      "partnerId": "商户ID",
      "prepayId": "预支付ID",
      "package": "扩展字段",
      "nonceStr": "随机字符串",
      "timeStamp": "时间戳",
      "sign": "签名"
    }
  }
}

说明: jsConfig用于调用支付SDK

---

4. 查询支付宝支付结果

接口路径: GET /api/front/pay/alipay/queryPayResult

请求头:

Authorization: Bearer {token}

请求参数:

orderNo: 订单号

返回参数:

{
  "code": 200,
  "msg": "success",
  "data": true
}

data说明:

• true: 支付成功
• false: 支付失败或未支付