一、微信支付分介绍
最近更新时间：2023.5.11
微信用户可以在具体应用场景中，开通微信支付分。开通后，用户可以在微信-钱包-支付分中查看分数和使用记录。（即需在应用场景中使用过一次，钱包才会出现支付分入口）
1.1 用户在场景中开通示意图
1.2 应用场景
- 免押租借：适用于物品租借场景，例如共享充电宝、共享雨伞、线上租赁平台等场景，用户支付分达到商户设置的分数门槛，即有机会获得免交押金权益。
- 免押速住：适用于酒店行业，用户支付分达到商户设置的分数门槛，即有机会获得免住宿押金，免预付房费等权益。
- 先享后付：适用于需预付费等场景，例如：网约车、寄快递、电动车充电、共享按摩椅等，用户支付分达到商户设置的分数门槛，即有机会获得先享受服务，后付款的权益。
- 智慧零售：适用于无人零售机柜，用户支付分达到商户设置的分数门槛，即有机会开柜购物。
1.3 间连模式支持开放行业场景
默认【需确认模式】支持行业场景：电商、出行、四轮充电桩、充电宝、线下共享设备、自助设备、酒旅；
二、接入流程
所有支付分场景商户提交资料均需一户一报备申请，商户将资料提供给汇付由汇付申报。申请资料如下：
2.1 商户需提交以下资料给机构侧申请
- 商户信息：
- 场景信息：商户准入需要符合以下的标准：
- 经营类目、接入场景须符合支付分支持类目场景及提交商户信息、场景信息。
- 商户客服电话要通过微信支付认证，并展示在账单详情页中。
- 接入商户一个月内整体投诉率<0.01%（含同主体）。
- 商户主体无违规，通过W4标准
微信审核后会需要提交补充资料，具体补充资料以微信通知为准。
举例：笔单金额及押金占比分布：
例如： 0-10元（85%） 10-50元 （12%） 50-99元（3%）或固定的押金金额及笔均。
2.2 微信侧验收及验收要求
接入方与汇付联调完成后要配合微信侧做验收，验收通过才能上线。
2.2.1 场景使用流程-视频
【第三人称视角】需要按照如下要求提供用户使用视频材料：
- 用户扫码（含场景）→点击目标产品→授权支付分→授权成功→跳转详情页→成功
- 视频内容需清晰展示实际产品/业务所在场景，成功后需验证消息通知；
举例：机器→扫码→启动充电→结束充电，都应清晰露出产品的位置和实体产品全貌
2.2.2 产品体验流程-录屏
【第一人称视角】需要按照如下步骤提供用户使用视频材料：
- 创建支付分订单：用户扫码→详情页面→确认页面→中间态→成功。 产品流需清晰录屏并按照该场景的支付分《设计规范》，该状态完成后，支付分订单状态为进行中，同时验证消息通知+跳转；
- 完结支付分订单：订单状态进行中→完结订单→订单完结成功→验证消息通知
2.2.3 异常订单体验-录屏
【第一人称视角】需要按照如下情况提供用户使用视频材料：
订单异常：订单状态为已创单或进行中→取消支付分订单→取消成功→验证订单状态→验证消息通知
注：验收为人工验收，预计1-5工作日完成，请商户先行查阅验收要求。
2.3 微信侧上线支付分服务
提供商户上线的信息，格式如下：
商户主体：
service_id：
商户号：
商户名称：
1、预计上线时间：XX年XX月XX日
2、上线计划：
（1）上线城市和计划：
（2）应急机制：若遇紧急情况，商户侧是否支持随时隐藏支付分入口
注：上线预计1-5个工作日完成
2.4 商户侧上线支付分服务
商户侧可自行安排灰度及全量上线支付分能力
三、接口说明
3.1 业务流程
3.2 服务订单与扣款订单
服务订单是商户的业务订单，服务订单完成后才能发起扣款订单。服务订单只能有一次支付成功的扣款订单。
状态变化：
- 创建、进行中：用户主动取消服务，调用【取消支付分订单】接口订单状态变为取消；
- 进行中：用户从商户APP/小程序/网页发起确认，调用【完成支付分订单】接口，订单状态变为已完成；
- 服务订单已完成状态之后才能发起支付，调用【登记扣款信息】；
3.3 调用流程
3.3.1 支付分订单流程
- 创建支付分订单接口： 商户调用此接口创建支付分订单，需提供服务信息、付费项目、优惠信息等。调用前商户需在斗拱开通微信支付分功能。
a. 用户在商户侧下单，商户调用后台接口创建支付分订单，通过接口返回获得跳转微信支付分小程序进行订单确认的必填参数“package”;
b. 调用前端方法跳转至微信，让用户完成确认订单操作，APP调起支付分-确认订单 、 JSAPI调起支付分-确认订单 、小程序调起支付分-确认订单
如果长时间未收到用户确认微信回调通知，可以调用【查询支付分订单接口】查询状态； - 申请完结订单接口： 用户使用完商户提供的产品或服务，在商户的APP/小程序/H5页面上确认订单，商户就可以调用本接口确认支付分订单已完结。
- 取消订单接口： 商户的支付分订单在"CREATED"或"DOING"状态时可以取消订单，商户调用本接口实现订单取消。注：此时还没有进入向用户扣款的支付流程；
- 查询支付分订单接口： 商户创建支付分订单后通过本接口查询服务订单的状态。
注：通过【查询支付分订单接口】也可以主动查询扣款情况。
- 如订单状态state=DONE，且收款状态collection.state=USER_PAID，代表扣款成功
- 如订单状态state=DOING，state_description=MCH_COMPLETE，且收款状态collection.state=USER_PAYING，代表扣款进行中
3.3.2 订单支付流程
商户扣款流程：
- 登记扣款接口： 用户完结订单后就进入支付分扣款流程。扣款流程分为两阶段：先登记扣款信息，再调支付分扣款接口完成支付；
- 支付分扣款接口： 商户登记扣款后用斗拱返回的扣款单号发起向用户扣款。
- 查询扣款信息： 商户可以调本接口通过支付服务订单查询关联的扣款订单号；
用户主动支付流程：
- 交易结果通知： 参见聚合正扫的间联模式异步通知；
- 微信支付成功回调通知： 通过支付成功通知将用户主动支付场景下的支付成功消息通知给商户。
附件说明
交互图样例
