高压氧套餐

此页面包含了高压氧套餐相关的接口，包括套餐列表,套餐详情等接口

套餐列表

接口信息

• 接口名称: 套餐列表
• 请求方式: POST
• 请求地址: /package-list
• 接口描述: 获取高压氧套餐列表
• 认证要求: 需要

请求参数

无

请求示例

{}

返回参数

参数名	类型	说明	示例
orderId	string	套餐 ID	"1"
name	string	套餐名称	"高压氧单次体验"
price	string	套餐价格	"98"
originalPrice	string	原价	"128"
description	string	套餐描述	"首次体验尊享优惠，专业医生指导，15分钟单人舱体验"
tag	string	套餐标签	"新人专享"
status	string	套餐状态	"available | not_available"
features	array	套餐特征	["专业医生指导", "单人舱体验", "15分钟疗程"]
validity	string	套餐有效期	"30天"
usageLimit	string	套餐使用限制	"限1次"

返回示例

{
  "errcode": 0,
  "msg": "",
  "rcursor": [
    {
      "orderId": "1",
      "name": "高压氧单次体验",
      "price": "98",
      "originalPrice": "128",
      "description": "首次体验尊享优惠，专业医生指导，15分钟单人舱体验",
      "tag": "新人专享",
      "status": "available",
      "features": ["专业医生指导", "单人舱体验", "15分钟疗程"],
      "validity": "30天",
      "usageLimit": "限1次"
    },
    {
      "orderId": "2",
      "name": "高压氧双月卡套餐",
      "price": "998",
      "originalPrice": "1388",
      "description": "专业疗程，效果显著，医疗级治疗体验",
      "tag": "康复必备",
      "status": "available",
      "features": ["30分钟疗程", "特效技术", "医生跟进"],
      "validity": "60天",
      "usageLimit": "无限次"
    }
  ]
}

立即购买

接口信息

• 接口名称: 立即购买
• 请求方式: POST
• 请求地址: /package-purchase
• 接口描述: 立即购买高压氧套餐
• 认证要求: 需要

请求参数

参数名	类型	必填	限制	说明	示例
orderId	string	是	-	套餐ID	"1"
patientId	string	是	-	患者ID	"1"

请求示例

{
  "orderId": "1",
  "patientId": "1"
}

返回参数

参数名	类型	说明	示例
prepayId	string	预支付ID	"wx201410272009395522657a690389285100"
outTradeNo	string	订单ID	"2"

返回示例

{
  "errcode": 0,
  "msg": "",
  "prepayId": "wx201410272009395522657a690389285100",
  "outTradeNo": "2"
}

TIP

用户点击「购买套餐」

↓

前端：调用后端 /package-purchase「创建套餐订单」接口（传套餐ID/就诊人ID）

↓

后端：

1. 业务校验（根据参数查询套餐库存/价格/预约日期是否在有效期内等等）
2. 生成内部订单逻辑,生成商户唯一订单号（out_trade_no）
3. 调用微信支付「统一下单接口」
4. 返回：prepay_id

↓

前端：调用小程序调起支付API调起用户支付系统组件

↓

├─ 支付成功 → 前端接收success回调 → 跳转「支付成功页」→ 轮询后端「订单状态接口」

├─ 支付失败 → 前端接收fail回调 → 提示用户（如“支付超时/取消”）→ 弹窗提示用户支付失败

└─ 支付未知（如网络中断）→ 轮询后端「订单状态接口」，直到订单状态变为已支付或失败

↓

后端：接收微信支付「支付结果通知」

1. 验证回调签名（确保是微信官方推送）
2. 更新订单状态（待支付→已支付）
3. 执行业务逻辑（如绑定用户套餐/生成消费凭证等）
4. 向微信返回“SUCCESS”（否则微信会重复推送）

↓ 用户：在详情页查看最终状态，完成购买流程

订单状态查询

接口信息

• 接口名称: 订单状态查询
• 请求方式: POST
• 请求地址: /order-status
• 接口描述: 查询高压氧套餐订单状态
• 认证要求: 需要

请求参数

参数名	类型	必填	限制	说明	示例
orderId	string	是	-	套餐ID	"1"
outTradeNo	string	是	-	商户订单号	"2"
patientId	string	是	-	患者ID	"1"

请求示例

{
  "orderId": "1",
  "outTradeNo": "2",
  "patientId": "1"
}

返回参数

参数名	类型	说明	示例
status	string	订单状态	"支付成功"

返回示例

{
  "errcode": 0,
  "msg": "",
  "status": "支付成功"
}