微企付

一、产品介绍

1.1产品概述

微企付是腾讯金融科技旗下的大额转账支付产品，专为中小微企业经营采购场景打造，解决企业大额转账需求。云商通2.0接入微企付小程序支付能力，为KA客户及行业版产品输出大额支付渠道能力，支持消费、担保消费、退款等核心交易场景，提供订单查询、通知、对账等全流程配套服务。

微企付使用示例：

云商通2.0对接微企付优势：

• 大额支付能力：适配企业经营采购的大额转账需求，突破常规支付额度限制
• 小程序原生体验：基于微信小程序环境实现支付流程，无需跳转外部APP，操作便捷
• 多付款渠道：支持个人银行卡、企业网银等付款方式，满足不同付款主体需求
• 全流程订单管理：云商通2.0提供订单创建、查询、通知、退款、对账一站式服务
• 资金不过通联：交易资金直接在付款方、银行、收款方之间流转，通联仅提供技术对接与订单管理服务，安全性高

商户通过云商通2.0接入微企付后，可在小程序环境实现企业/个人大额转账支付，微企付支持个人银行卡、企业网银等付款渠道，交易完成后合并结算，云商通2.0为商户提供完整的订单管理、账务处理及对账能力。

1.2适用场景

• 企业原材料/设备采购的大额付款
• 企业间的货款、服务费等经营性资金结算
• 大宗商品交易的大额支付
• 其他企业经营场景下的大额转账需求等

1.3商户入网

所有接入微企付的商户需遵循“一户一报备加白”原则，由通联银华统一向腾讯微企付提交商户信息及费率信息完成报备，完成后商户通过微企付平台完成商家入驻，注册微企付商户账号（企业ID），该账号与企业社会统一信用代码唯一对应，为交易收付唯一标识。

1.3.1需提交资料

商户向通联机构部报备时，需提供相关完整资料，确保信息真实有效、与企业工商信息一致：

1.3.2准入标准

• 商户经营主体为合法存续的企业/个体工商户，无违法违规经营记录，工商信息无异常
• 商户经营场景为合法经营性场景，严禁一切非法行为
• 商户提交的资料真实、完整、有效，与微企付、云商通2.0备案信息一致
• 商户需配合通联完成云商通2.0接口联调，确保交易流程正常
• 商户无重大支付投诉、逾期等不良记录，符合腾讯微企付及通联支付的合规要求

1.3.3入网流程

商户接入微企付的整体流程分为资料报备加白、微企付平台入驻、云商通2.0权限配置三个环节

• 商户准备入网资料，通过通联机构部完成信息报备
• 通联银华以科技服务商身份将商户信息及费率信息提交至腾讯微企付，完成商户报备加白
• 报备加白通过后，商户通过腾讯微企付平台商家入驻功能完成进件，注册微企付商户账号（企业ID），该账号自动绑定通联银华的微企付接入平台账号
• 通联机构部为商户在云商通2.0完成【应用管理-应用支付产品权限配置】，开启“微企付”支付产品权限，配置渠道商户号（微企付企业ID）等核心参数

二、技术开发

2.1开发环境准备

• 开发语言：支持Java、Python、PHP、Node.js等任意主流开发语言，适配云商通2.0接口调用规范
• 网络环境：商户服务器需具备公网访问能力，可正常调用云商通2.0接口及腾讯微企付相关接口
• 安全协议：服务器必须部署HTTPS协议，确保接口请求、数据传输的安全性
• 开发人员权限：开发人员需提供姓名、身份证、手机号信息至通联机构部，由机构部为开发者配置微企付开发者中心权限，获取接入所需密钥及参数。

商户完成报备加白及微企付入驻后，通过通联机构部获取以下微企付接入核心参数，同时在云商通2.0后台配置相关参数：

2.2接入安全及合规要求

• 签名校验：所有云商通2.0接口请求参数需按规范进行签名加密，响应参数、异步回调通知必须完成验签，未通过验签的信息严禁处理，不得据此更新订单状态；
• 防重复：商户订单号、渠道流水号需全局唯一且不可重复使用；接口调用超时后禁止直接重复提交请求，需先通过订单查询接口确认订单状态后再操作；
• 金额规范：接口中所有金额字段禁止金额四舍五入误差；
• 参数存储：接入平台账号、私钥、商户号等核心信息需加密存储，严禁硬编码在代码中，防止信息泄露；
• 订单信息校验：订单核心信息（金额、付款方、收款方）禁止采信前端传参，必须以商户后台计算/云商通2.0返回结果为准。

2.3上线部署

商户需提供以下上线信息，提交至通联支付对接人，由通联支付统一提交至腾讯微企付，预计1-5个工作日完成上线配置：

• 基础信息：商户主体名称、微企付企业ID、通联云商通2.0应用ID、商户简称
• 上线计划：预计上线时间、核心业务场景

三、接口说明

3.1核心开发内容

3.2对接规范

• 测试环境：https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
• 生产环境：https://ibsapi.allinpay.com/yst/yst-service-api/tx/handle
• 相关接口：【2085-消费申请】【2089-担保消费申请】【2094-退款申请】【3001-订单状态查询】【3002-订单详情查询】【2295-订单关闭】【4002-应用集合对账文件下载】，调用消费、担保消费接口时支付产品需固定上送“WQF”
• 调用通联接口，统一使用POST形式提交，数据格式统一为JSON，微企付API规范参考：https://businesspay.qq.com/p/doc/mse/api/server.html#%E5%B0%8F%E7%A8%8B%E5%BA%8F%E6%94%AF%E4%BB%98，小程序支付流程参考：https://businesspay.qq.com/p/doc/mse/flow/mp/，签名及SDK示例参考：https://prodoc.allinpay.com/doc/1360/

3.3消费流程

微企付小程序支付的核心流程为商户下单→云商通2.0对接微企付预下单→小程序跳转收银台→完成支付→结果通知/查询，具体步骤如下：

• 付款人在商户小程序选择商品下单，选择“微企付”支付方式；
• 商户后台调用云商通2.0【2085-消费申请】/【2095-担保消费申请】接口，支付产品上送WQF，传入支付金额、订单过期时间、商品信息等核心参数；
• 云商通2.0校验商户微企付产品权限，权限通过后调用微企付【mp支付预下单】+【获取跳转对象信息】接口；
• 云商通2.0向商户后台返回接口响应，其中chnlFrontParamInfo渠道参数信息包含WQFChnlFrontParamInfo微企付前端跳转信息对象，含小程序appid、路径、原始id等核心跳转参数
• 商户小程序获取WQFChnlFrontParamInfo参数，按微企付官方规范跳转至微企付半屏小程序收银台；
• 付款人在收银台选择“个人银行卡”/“企业网银”，完成大额转账支付；
• 微企付将支付结果异步通知至云商通2.0，云商通2.0处理订单状态后，通过【订单结果通知】接口向商户推送异步回调；
• 若商户未及时收到回调，可主动调用【3001-订单状态查询】/【3002-订单详情查询】接口，云商通2.0对接微企付【支付查询（外单号）】接口返回订单详情，商户更新订单状态。

面向小程序商城，微企付提供小程序生态最新能力“半屏”模式的接入方案。无需弹出小程序跳转弹框，即可拉起微企付银行选择收银台，示例如下：

3.4退款流程

• 商户发起退款：商户后台调用云商通2.0【2094-退款申请】接口，传入原订单号、退款金额（分）、请求渠道流水号、退款原因等核心参数
• 接口校验：云商通2.0校验退款时效（原交易时间≤180天）、累计退款金额（≤原订单支付金额）、退款次数（单笔交易≤50次），校验通过后对接微企付【2094-退款申请】接口
• 退款受理：接口实时返回退款受理状态，微企付退款状态为ACCEPTED（受理成功）则订单状态更新为“进行中”
• 结果通知：微企付退款状态变更后，将结果异步推送至云商通2.0，云商通2.0通过【订单结果通知】接口向商户推送退款结果；
• 状态查询：若未收到退款通知，商户可主动调用【3001-订单状态查询】/【3002-订单详情查询】接口，云商通2.0对接微企付【退款查询（外单号）】接口返回退款详情；
• 账务处理：退款成功后，银行存管/自主管理模式下对原订单记账进行逆向处理，交易处理/银行托管模式下不记账。

3.5订单管理

3.5.1订单创建

• 核心功能：实现微企付模式下消费、担保消费订单创建，获取微企付收银台跳转信息
• 关联接口：【2085-消费申请】【2089-担保消费申请】
• 开发要点：支付产品上送WQF；校验微企付产品权限；接收并解析WQFChnlFrontParamInfo对象

3.5.2订单状态管理

支付状态映射：

• 订单查询：调用【3001-订单状态查询】/【3002-订单详情查询】接口，获取WQFChannelParamInfo（微企付渠道参数信息），含支付/退款单号、金额、手续费、付款人/收款方信息、支付/退款时间等核心内容
• 订单关闭：仅支持“进行中”状态订单关单，需上送原通联订单号及关单原因（必填），关单成功后订单状态更新为“交易失败”

3.5.3异步通知处理

• 支付结果通知：接收【订单结果通知】接口推送的支付状态，验签通过后返回success，更新订单状态
• 退款结果通知：接收【订单结果通知】接口推送的退款状态，验签通过后返回success，更新退款订单状态并完成账务逆向处理

3.6订单对账

• 对账文件获取：

接口调用：调用【4002-应用集合对账文件下载】，下载订单对账文件。

3.7附录

云商通内部接口名<——>微企付官方接口名映射表