微信APP支付

一、支付产品介绍

1.1产品概述

微信APP支付是微信支付面向移动应用提供的原生支付能力，用户在商户APP内完成下单操作后，可以直接拉起微信客户端完成支付流程，支付完成后自动返回商户APP展示支付结果。支持在消费、担保消费、充值接口调用此支付模式

1.2适用场景

1.3商户入网

商户可联系通联分公司人员签署协议提交入网材料，审核通过入网成功后，即可进行支付产品开通。

二、技术开发准备

2.1开发环境准备

第一步：密钥获取（云梯）

设置商户公私钥、加密key

第二步：公共参数获取（云梯）

下载通联公钥

第三步：对接规范

调用通联接口，统一使用POST形式提交，数据格式统一为JOSN，相关SDK及签名方法如下：SDK示例：https://prodoc.allinpay.com/doc/1360/

三、开发指引

3.1API列表

3.2消费流程

微信APP支付的核心流程为：商户APP下单→云商通2.0对接微信支付预下单→APP调起微信收银台→用户完成支付→结果通知/查询。

详细步骤说明：

步骤一：订单创建与预下单

用户在商户APP内浏览商品/服务，完成下单操作，选择“微信支付”；

商户后端接收下单请求，调用云商通2.0【2085-消费申请】/【2089-担保消费申请】接口，支付产品上送 WECHAT_APP_PAY，传入支付金额、订单过期时间等核心参数；

云商通2.0校验商户APP支付权限，权限通过后调用收银宝统一支付接口，向微信支付发起下单请求；

云商通2.0向商户后端返回接口响应，其中 chnlFrontParamInfo 渠道参数信息包含 payinfo（调起微信支付的参数串）。

步骤二：调起支付

商户APP获取payinfo后，通过微信官方OpenSDK调用相关方法，拉起微信客户端收银台；

用户在微信收银台完成支付。

步骤三：结果通知

微信支付将支付结果异步通知至云商通2.0，云商通2.0处理订单状态后，通过【订单结果通知】接口向商户推送异步回调；

商户接收通知并验签通过后，更新系统订单状态。

步骤四：兜底查询

若商户未及时收到回调，可主动调用【3001-订单状态查询】/【3002-订单详情查询】接口查询订单状态，确保订单状态一致。

关键字段说明

消费申请接口关键字段（支付产品=微信APP支付）

返回参数关注以下字段：

chnlFrontParamInfo.payinfo参数说明：

3.3退款流程

若用户需要退款则可调用退款接口，将接口调用成功后支付金额将原路退还给客户。退款需上传参数如下：

上传参数时“orgRespTraceNum”和“orgReqTraceNum+orgTransDate”二选一即可成功调用退款接口

退款支持部分退款和全额退款，同时支持多次退款。退款金额不能大于支付金额。

3.4订单管理

支付状态映射：

退款状态说明：

异步通知：支付完成后，通联将支付结果推送到商户异步地址【订单结果通知】；

主动查询：若长时间未收到异步通知，可调用【3001-订单状态查询】接口主动查询订单状态；

详情查询：如需获取更详细的订单信息，可调用【3002-订单详情查询】接口，获取订单完整信息；

门户查询：登录云梯门户，通过【订单管理】-【订单查询】菜单查询，支持订单信息导出。

仅支持“进行中”状态订单关单，需上送原通联订单号及关单原因（必填），关单成功后订单状态更新为“交易失败”。

3.5订单对账

为满足财务对账需求，通联支持商户下载对账文件。具体方式如下：

门户下载对账文件：可在商户门户【对账单下载】菜单下载对账文件

调用API接口获取对账文件

商户可调用【下载商户对账文件】接口下载对账文件，支持日度、月度对账文件获取，文件格式支持CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。