2.5 KiB
2.5 KiB
M08-A 充值微信支付 API
-
POST /app-api/recharge/orders/:rechargeOrderId/wechat-prepay- 鉴权:顾客登录态,需
profile.read。 - 行为:校验充值单属于当前用户,读取微信支付配置和当前用户 openid,创建 JSAPI 预支付。
- 返回:
rechargeOrderId、rechargeNo、amountCents、timeStamp、nonceStr、package、signType、paySign。
- 鉴权:顾客登录态,需
-
POST /app-api/recharge/wechat/notify- 鉴权:微信支付平台证书签名和 AES-GCM 资源解密。
- 行为:按
out_trade_no定位充值单,校验金额,写入qipai_payment_callbacks幂等记录,成功后给钱包现金/赠送余额入账。 - 隐私:通知 payload 入库前移除
payer等敏感对象。
M08-A 权益与余额下单抵扣
-
POST /app-api/orders/reserve- 新增可选
benefits对象:couponGrantId、packageHoldingId、packageMinutes、packageCreditCents、clientRequestId。 - 行为:只接受权益 ID 和请求幂等号,不接受客户端自报总价;后端按报价、权益规则和剩余量重新计算
discountCents、packageCreditCents与订单totalCents。 - 返回:保留原订单预占结构,新增
benefitReservation,包含冻结状态、抵扣金额、套餐抵扣金额、分钟和使用记录。
- 新增可选
-
POST /app-api/paymentsprovider继续支持WECHAT、TEST,新增顾客端BALANCE实际扣款闭环。BALANCE行为:按当前订单应付金额创建支付单,在同一事务内从门店钱包按赠送余额优先、现金余额补足扣款;成功后支付单状态为SUCCEEDED,订单满足金额时推进为PAID并确认冻结权益。WECHAT/TEST成功路径:支付通知或测试回调成功后统一确认冻结优惠券和套餐;重复通知保持幂等。
-
POST /app-api/orders/:orderId/cancel- 行为补充:订单取消释放房间预占和访问权限时,同时释放仍处于
FROZEN的优惠券和套餐持有记录。
- 行为补充:订单取消释放房间预占和访问权限时,同时释放仍处于
M08-A 权益可视化选择器补充
-
GET /app-api/profile/benefits- 小程序房间页现在复用该接口作为下单权益选择器数据源。
- 前端按当前
storeId、roomId、权益状态和剩余量过滤可选项。
-
POST /app-api/orders/reserve- 行为补充:
TIME类型优惠券不再只冻结记录,会按当前服务端锁定单价和券分钟数折算成订单折扣;最终折扣仍受服务端计价规则限制,不允许抵扣押金外的非法金额。
- 行为补充: