收银台与支付多端适配

​

核心字段与适用场景

​

返回与失效核心规则

​

1. 二选一严格互斥下发

• 系统根据 Partner 合作方绑定的客户端宿主环境自动识别：
  • Web/桌面端环境：接口响应中仅下发 paymentUrl，miniProgramPayInfo 字段彻底隐藏；
  • 微信小程序环境：接口响应中仅下发 miniProgramPayInfo，paymentUrl 字段彻底隐藏；
• 杜绝客户端因收到混杂数据而导致的分支判断混乱。

​

2. 非待支付状态统一置空 (null)

• 当订单处于已支付确认 (Confirmed)、已取消 (Canceled)，或超过 30 分钟支付时效自动失效后：
• 对应的支付字段依然在 JSON 中保留，但其值统一安全置为 null（例如："paymentUrl": null）。
• 智能体检测到支付字段为 null 时，应提示用户当前订单已完成支付或已超时，无需再次引导付款。

​

客户端接入代码范例

​

1. Web 浏览器与桌面客户端 (JavaScript / TypeScript)

if (bookingResult.paymentUrl) {
  // 引导用户在新窗口打开收银台
  window.open(bookingResult.paymentUrl, '_blank');
} else {
  console.log("订单非待支付状态或支付链接已失效");
}

​

2. 微信小程序环境 (JavaScript)

const payInfo = bookingResult.miniProgramPayInfo;

if (payInfo && payInfo.appId) {
  wx.navigateToMiniProgram({
    appId: payInfo.appId,
    path: `${payInfo.path}?${payInfo.query}`,
    success(res) {
      console.log("成功拉起微信收银台");
    },
    fail(err) {
      console.error("调起收银台失败", err);
    }
  });
}

​

支付倒计时与状态流转

1. 30 分钟锁价与支付窗口：
   • 订单生成后，系统保留房源并锁定总价 30 分钟；
   • 用户未在 30 分钟内完成支付的，订单状态将变更为 Expired，库存自动释放。
2. 支付成功后状态同步：
   • 用户在收银台付款成功后，订单状态即时流转为 Confirmed；
   • 调用 getHotelOrderDetail 即可查询到正式的入离凭证号与酒店联系电话。