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

1.2适用场景
企业微企付是通联支付联合微众银行推出的企业级支付产品,支持企业通过企业网银、微众银行企业账户等渠道完成大额付款,适用于企业间各类经营性资金结算场景。
|
业务场景 |
场景特点 |
典型应用案例 |
|
线上场景 |
企业采购或结算时,通过企业网银或微众银行企业账户发起大额支付,资金直接从企业对公账户划转至收款方账户。 |
原材料/设备采购:制造企业向供应商支付原材料或设备采购款;企业间货款/服务费结算:企业与企业之间支付货款、服务费等经营性资金;大宗商品交易:钢铁、能源、农产品等大宗商品买卖中的大额支付;其他经营场景:保证金缴纳、项目合作款、渠道分销结算等企业经营中的大额转账需求。 |
|
线下场景 |
无 |
无 |
1.3商户入网
所有接入微企付的商户需遵循“一户一报备加白”原则,由通联银华统一向腾讯微企付提交商户信息及费率信息完成报备,完成后商户通过微企付平台完成商家入驻,注册微企付商户账号(企业ID),该账号与企业社会统一信用代码唯一对应,为交易收付唯一标识。
1.3.1需提交资料
商户向通联机构部报备时,需提供相关完整资料,确保信息真实有效、与企业工商信息一致:
|
资料类型 |
具体内容 |
备注 |
|
企业基础信息 |
企业全称、社会统一信用代码 |
与营业执照登记信息一致 |
|
企业工商注册地址、经营地址 |
|
|
|
企业对公银行账户信息(开户行、账号、户名) |
用于资金结算 |
|
|
商户资质信息 |
营业执照扫描件,需要加盖公章 |
|
|
法人身份证正反面扫描件 |
|
|
|
商户联系人姓名、手机号、邮箱 |
|
|
|
业务信息 |
主营业务类型、核心经营场景 |
需匹配微企付大额采购/经营结算场景 |
|
预计交易规模、单笔交易金额区间 |
方便微企付评估场景风险 |
|
|
费率及渠道信息 |
与通联侧确认的微企付交易费率 |
|
1.3.2准入标准
- 商户经营主体为合法存续的企业/个体工商户,无违法违规经营记录,工商信息无异常
- 商户经营场景为合法经营性场景,严禁一切非法行为
- 商户提交的资料真实、完整、有效,与微企付、云商通0备案信息一致
- 商户需配合通联完成云商通0接口联调,确保交易流程正常
- 商户无重大支付投诉、逾期等不良记录,符合腾讯微企付及通联支付的合规要求
1.3.3入网流程
商户接入微企付的整体流程分为资料报备加白、微企付平台入驻、云商通2.0权限配置三个环节
- 商户准备入网资料,通过通联机构部完成信息报备
- 通联银华以科技服务商身份将商户信息及费率信息提交至腾讯微企付,完成商户报备加白
- 报备加白通过后,商户通过腾讯微企付平台商家入驻功能完成进件,注册微企付商户账号(企业ID),该账号自动绑定通联银华的微企付接入平台账号
- 通联机构部为商户在云商通0完成【应用管理-应用支付产品权限配置】,开启“微企付”支付产品权限,配置渠道商户号(微企付企业ID)等核心参数
二、技术开发准备
2.1开发环境准备
第一步:密钥获取(云梯)
设置商户公私钥、加密key


第二步:公共参数获取(云梯)
下载通联公钥

第三步:对接规范
调用通联接口,统一使用POST形式提交,数据格式统一为JOSN,相关SDK及签名方法如下:SDK示例:https://prodoc.allinpay.com/doc/1360/
三、开发指引
商户通过通联支付接入微企付,核心调用【2085-消费申请】/【2089-担保消费申请】接口创建订单,获取微企付收银台跳转信息,引导用户完成大额支付。接口调用需遵循通联支付接口规范,确保参数正确、签名有效。
3.1API列表
|
功能 |
接口 |
描述 |
|
订单创建 |
【2085-消费申请】/【2089-担保消费申请】 |
支付产品上送 WQF,生成微企付订单,获取收银台跳转信息 |
|
支付结果回调处理 |
【订单结果通知】 |
验证回调签名、更新订单状态、回复success防止重复回调 |
|
订单查询 |
【3001-订单状态查询】/【3002-订单详情查询】 |
查询订单状态,未收到回调时主动核查订单信息 |
|
退款 |
【2294-退款申请】 |
处理交易退款请求,将款项按原路退还至用户账户 |
|
订单关闭 |
【2295-订单关闭】 |
对进行中的微企付订单发起关单操作 |
|
订单对账 |
【4002-应用集合对账文件下载】 |
下载对账文件,完成三方账务核对 |
3.2消费流程
微企付小程序支付的核心流程为:商户下单→云商通2.0对接微企付预下单→小程序跳转收银台→完成支付→结果通知/查询。

详细步骤说明:
步骤一:订单创建与预下单
付款人在商户小程序选择商品下单,选择“微企付”支付方式;
商户后端调用云商通2.0【2085-消费申请】/【2089-担保消费申请】接口,支付产品上送 WQF,传入支付金额、订单过期时间、商品信息等核心参数;
云商通2.0校验商户微企付产品权限,权限通过后调用微企付【mp支付预下单】+【获取跳转对象信息】接口;
云商通2.0向商户后端返回接口响应,其中 chnlFrontParamInfo 渠道参数信息包含 WQFChnlFrontParamInfo 微企付前端跳转信息对象(含小程序appid、路径、原始id等核心跳转参数)。
步骤二:跳转支付
商户小程序获取 WQFChnlFrontParamInfo 参数,按微企付官方规范跳转至微企付半屏小程序收银台;
付款人在收银台选择“个人银行卡”或“企业网银”,完成大额转账支付。
说明:面向小程序商城,微企付提供“半屏”模式的接入方案,无需弹出小程序跳转弹框,即可直接拉起微企付银行选择收银台。
步骤三:结果通知
微企付将支付结果异步通知至云商通2.0,云商通2.0处理订单状态后,通过【订单结果通知】接口向商户推送异步回调。
步骤四:兜底查询
若商户未及时收到回调,可主动调用【3001-订单状态查询】/【3002-订单详情查询】接口,云商通2.0对接微企付【支付查询(外单号)】接口返回订单详情。
关键字段说明
消费申请接口关键字段(支付产品=微企付)
|
字段 |
字段类型 |
是否必填 |
字段名称 |
说明 |
|
payMode |
JSONObject |
是 |
支付模式 |
支付产品为微企付时,固定上送 WQF |
|
signNum |
String |
是 |
商户会员编号-付款人 |
付款会员的商户会员编号 |
|
receiverSignNum |
String |
是 |
商户会员编号-收款人 |
收款会员的商户会员编号 |
|
orderAmount |
Long |
是 |
订单金额 |
单位:分 |
|
reqTraceNum |
String |
是 |
商户订单号 |
商户侧唯一,不可重复 |
|
orderValidTime |
String |
否 |
订单过期时间 |
格式:yyyy-MM-dd HH:mm:ss |
|
respUrl |
String |
否 |
后台通知地址 |
订单结果异步通知地址 |
返回参数关注以下字段:
|
字段 |
字段类型 |
是否必填 |
字段名称 |
|
respTraceNum |
String |
是 |
通联订单号,可用于后续查询订单状态 |
|
result |
String |
否 |
订单状态 |
|
chnlFrontParamInfo |
JSONObject |
否 |
渠道参数信息,含 WQFChnlFrontParamInfo 微企付前端跳转信息对象 |
|
respCode |
String |
是 |
业务返回码:00000代表成功;66666/66667代表处理中 |
|
respMsg |
String |
是 |
业务返回说明,失败时返回失败原因 |
chnlFrontParamInfo.WQFChnlFrontParamInfo 跳转参数说明:
|
字段 |
字段类型 |
说明 |
|
appId |
String |
微企付半屏收银台小程序appid |
|
path |
String |
微企付半屏收银台跳转路径 |
|
原始id |
String |
微企付半屏收银台原始id |
3.3退款流程
若用户需要退款则可调用退款接口,将接口调用成功后支付金额将原路退还给客户。退款需上传参数如下:
|
字段 |
字段类型 |
是否必填 |
字段名称 |
|
orgRespTraceNum |
String |
否 |
原通联订单号 |
|
orgReqTraceNum |
String |
否 |
商户订单号,唯一不可重复 |
|
orgTransDate |
String |
否 |
订单时间,yyyy-MM-dd |
|
orderAmount |
Long |
是 |
退款总金额(单位:分) |
|
respUrl |
String |
否 |
后台通知地址 |
- 上传参数时“orgRespTraceNum”和“orgReqTraceNum+orgTransDate”二选一即可成功调用退款接口
- 退款支持部分退款和全额退款,同时支持多次退款。退款金额不能大于支付金额。
3.4订单管理
支付状态映射:
|
微企付支付状态 |
云商通2.0订单状态 |
说明 |
|
PROCESSING / BANK_ACCEPTED / CLEARING |
0:进行中 |
支付处理中 / 提交银行成功 / 银行清算中 |
|
SUCCEEDED |
1:交易成功 |
支付完成,资金待D+1结算 |
|
REVOKED / CLOSED |
2:交易失败 |
支付退票 / 支付关单 |
退款状态说明:
|
订单类型 |
订单状态 |
场景说明 |
|
退款 |
0:进行中 |
退款请求已受理,银行正在处理退款 |
|
退款 |
1:交易成功 |
退款成功,资金已原路退回用户账户 |
|
退款 |
2:交易失败 |
退款失败:超过退款有效期、账户异常等原因 |
异步通知:支付完成后,通联将支付结果推送到商户异步地址【订单结果通知】;
主动查询:若长时间未收到异步通知,可调用【3001-订单状态查询】接口主动查询订单状态,获取 WQFChannelParamInfo(微企付渠道参数信息),含支付/退款单号、金额、手续费、付款人/收款方信息、支付/退款时间等核心内容;
详情查询:如需获取更详细的订单信息,可调用【3002-订单详情查询】接口;
门户查询:登录云梯门户,通过【订单管理】-【订单查询】菜单查询,支持订单信息导出。
仅支持“进行中”状态订单关单,需上送原通联订单号及关单原因(必填),关单成功后订单状态更新为“交易失败”。
3.5订单对账
为满足财务对账需求,通联支持商户下载对账文件。具体方式如下:
门户下载对账文件:可在商户门户【对账单下载】菜单下载对账文件


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