一、支付产品介绍
1.1产品概述
微信支付分是微信基于用户身份特质、支付行为、使用历史等多维度综合计算的信用分值，为用户与商户搭建“先享后付”“免押使用”的信用服务桥梁，降低用户消费门槛、提升商户转化效率。
注：用户开通时需同意微信支付分相关协议及免密代扣协议，若用户拒绝授权，则无法使用该场景下的微信支付分服务。
1.2适用场景
|
业务场景 |
场景特点 |
典型应用案例 |
|
线上场景 |
用户在线上平台下单，系统基于微信支付分评估用户信用，符合条件的用户可享受免押金、先用后付等权益，无需跳转微信支付分小程序即可完成授权（免确认模式），或需跳转小程序完成单次授权（需确认模式）。 |
电商平台：用户下单时选择“先用后付”，系统自动完成信用评估，用户无需确认即可下单，收到商品后再付款；共享出行：用户扫码用车时，系统自动完成信用评估，符合条件的用户可免押金骑行，行程结束后自动扣费。 |
|
线下场景 |
用户在线下场景通过扫码或自助终端发起服务请求，系统基于微信支付分进行信用评估，符合条件的用户可享受免押金、先享后付等权益。 |
免押租借：共享充电宝、共享雨伞、租借数码设备等场景，用户扫码租借时系统自动评估信用分，符合条件的用户可免押金租借；免押速住：酒店、民宿场景，用户在前台扫码或通过小程序预订，系统自动完成信用评估，符合条件的用户可免押金入住，离店时自动扣费；智慧零售：智能货柜、无人便利店场景，用户扫码开门取货，系统基于信用评估允许先取货后扣款，离柜时自动结算。 |
1.3商户入网
商户可联系通联分公司人员签署协议提交入网材料，审核通过入网成功后，即可进行支付产品开通。
二、技术开发
2.1开发环境准备
第一步：密钥获取（云梯）
设置商户公私钥、加密key
第二步：公共参数获取（云梯）
下载通联公钥
第三步：对接规范
调用通联接口，统一使用POST形式提交，数据格式统一为JOSN，相关SDK及签名方法如下：SDK示例：https://prodoc.allinpay.com/doc/1360/
三、开发指引
商户通过通联支付接入微信支付分，核心调用【4006-微信支付分服务单管理前置接口】进行服务单全生命周期管理，关联消费接口完成扣款。接口调用需遵循通联支付接口规范，确保参数正确、签名有效。
3.1API列表
|
功能 |
接口 |
描述 |
|
服务单管理 |
【4006-微信支付分服务单管理前置接口】 |
实现服务单创建（opType=4）、授权查询（opType=2/1）、完结（opType=6）全流程管理 |
|
扣款处理 |
【2085-消费申请】/【2089-担保消费申请】 |
支付产品上送 WECHAT_SCORE_VSP，发起扣款请求 |
|
支付结果回调处理 |
【订单结果通知】 |
验证回调签名、更新订单状态、回复success防止重复回调 |
|
订单查询 |
【3001-订单状态查询】/【3002-订单详情查询】 |
查询订单状态，未收到回调时主动核查订单信息 |
|
退款 |
【2294-退款申请】 |
处理交易退款请求，将款项按原路退还至用户账户 |
|
订单对账 |
【4002-应用集合对账文件下载】 |
下载对账文件，完成三方账务核对 |
3.2消费流程
微信支付分消费流程分为商户主动扣款与用户主动支付两种，具体如下：
3.2.1商户主动扣款流程
服务单完结：商户后台调用【4006-微信支付分服务单管理前置接口】，opType=6完结服务单，确认实际扣款金额（outOrderNo需保持唯一）；
发起扣款：调用【2085-消费申请】或【2089-担保消费申请】接口，支付产品上送 WECHAT_SCORE_VSP，发起扣款请求；
转发扣款：云商通2.0将请求转发至微信支付分，从用户绑定账户扣款；
结果返回：微信支付分返回扣款结果，云商通2.0同步至商户后台，并通过【订单结果通知】推送扣款回调通知。
3.2.2用户主动支付流程
用户发起支付：服务完结后，用户在微信支付分小程序“我的订单”中找到待支付订单，发起主动支付；
预下单通知：微信支付分生成预下单信息，异步通知云商通2.0，云商通2.0同步通知商户后台；
支付完成：用户支付成功后，微信支付分发送支付成功回调至云商通2.0，云商通2.0同步推送至商户后台；
状态更新：商户接收通知后，更新订单状态为“已支付”，完成支付。
3.2.3接口字段说明
消费申请接口关键字段（支付产品=微信支付分）
|
字段 |
字段类型 |
是否必填 |
字段名称 |
说明 |
|
payMode |
JSONObject |
是 |
支付模式 |
支付产品为微信支付分时，固定上送 WECHAT_SCORE_VSP |
|
signNum |
String |
是 |
商户会员编号-付款人 |
付款会员的商户会员编号 |
|
receiverSignNum |
String |
是 |
商户会员编号-收款人 |
收款会员的商户会员编号 |
|
orderAmount |
Long |
是 |
订单金额 |
单位：分 |
|
reqTraceNum |
String |
是 |
商户订单号 |
商户侧唯一，不可重复 |
|
respUrl |
String |
否 |
后台通知地址 |
订单结果异步通知地址 |
返回参数关注以下字段：
|
字段 |
字段类型 |
是否必填 |
字段名称 |
|
respTraceNum |
String |
是 |
通联订单号，可用于后续查询订单状态 |
|
result |
String |
否 |
订单状态 |
|
respCode |
String |
是 |
业务返回码：00000代表成功；66666/66667代表处理中 |
|
respMsg |
String |
是 |
业务返回说明，失败时返回失败原因 |
3.3退款流程
若用户需要退款则可调用退款接口，将接口调用成功后支付金额将原路退还给客户。退款需上传参数如下：
|
字段 |
字段类型 |
是否必填 |
字段名称 |
|
orgRespTraceNum |
String |
否 |
原通联订单号 |
|
orgReqTraceNum |
String |
否 |
商户订单号，唯一不可重复 |
|
orgTransDate |
String |
否 |
订单时间，yyyy-MM-dd |
|
orderAmount |
Long |
是 |
退款总金额（单位：分） |
|
respUrl |
String |
否 |
后台通知地址 |
- 上传参数时“orgRespTraceNum”和“orgReqTraceNum+orgTransDate”二选一即可成功调用退款接口
- 退款支持部分退款和全额退款，同时支持多次退款。退款金额不能大于支付金额。
3.4 订单管理
订单状态说明
|
订单类型 |
订单状态 |
场景说明 |
|
消费/担保消费 |
0：进行中 |
扣款请求已发起，等待微信支付分处理扣款 |
|
1：交易成功 |
微信支付分扣款成功，资金已到账 |
|
|
2：交易失败 |
扣款失败：用户余额不足、账户异常、微信风控拦截等原因 |
|
|
退款 |
0：进行中 |
退款请求已受理，微信支付分/银行正在处理退款 |
|
1：交易成功 |
退款成功，资金已原路退回用户账户 |
|
|
2：交易失败 |
退款失败：超过退款有效期、账户异常等原因 |
订单状态获取方式
异步通知：支付完成后，通联将支付结果推送到商户异步地址【订单结果通知】；
主动查询：若长时间未收到异步通知，可调用【3001-订单状态查询】接口主动查询订单状态；
详情查询：如需获取更详细的订单信息，可调用【3002-订单详情查询】接口；
门户查询：登录云梯门户，通过【订单管理】-【订单查询】菜单查询，支持订单信息导出。
3.5订单对账
为满足财务对账需求，通联支持商户下载对账文件。具体方式如下：
门户下载对账文件：可在商户门户【对账单下载】菜单下载对账文件
调用API接口获取对账文件
商户可调用【下载商户对账文件】接口下载对账文件，支持日度、月度对账文件获取，文件格式支持CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。