记录--H5页面对接微信支付踩坑杂记

发布时间 2023-09-15 18:54:57作者: 林恒

这里给大家分享我在网上总结出来的一些知识,希望对大家有所帮助

背景

  • 应用背景:vite搭建的vue3项目
  • 需求背景:功能都涉及了支付业务,故需要和外部支付系统对接
  • 外部支付系统:聚合支付、微信小程序支付、微信H5支付

目录

读完本文,你将会对以下几个坑点有所了解:

  • 对接第三方服务商过程踩坑
  • 对接小程序支付踩坑
  • 对接微信H5支付踩坑
  • 关于客户端页面的H5支付踩坑

一、  对接第三方服务商过程踩坑

踩坑1:业务前期对接第三方服务商,一开始完全是由业务和服务商对接,研发团队没有参与,技术风控风险没能及时发现

解决1:只要涉及到研发工作,业务需通知研发团队需同时和服务商对接,这样研发团队可以尽早了解到相关风险

一开始和服务商聚合支付对接H5的支付功能,只有业务参与了。待业务敲定后再通知研发团队要使用服务商支付服务,接着研发团队和服务商研发团队 对接技术方案,研发完成上线

直到小程序被封第一次,研发团队才知道聚合支付服务是免费的,且服务商聚合支付并没有完全被微信支付官方认可 所以,当小程序被封后,服务商解决问题的态度是不积极的

踩坑2:对接第三方服务时,不要被对方的方案牵着走

解决2:使用第三方服务过程中,若方案需要调整,内部需要及时同步并坚定自身方案和立场

H5应用最先方案是和服务商进行H5支付对接,但在对接过程中,H5支付走不通。对方未告知具体原因的情况下,让我们换成小程序支付,内部研发团队没有经过统方案调整同步的情况下,服务商私自更改了对接方案;固内部整个研发团队被推动着改变了支付方案,使后续开发进行方案调整非常被动

具体分步解决

  1. 研发方案有变动,内部应同步并统一变动方案
  2. 统一方案后再与第三方平台对接

二、  对接微信小程序支付踩坑

踩坑3:使用了聚合支付,聚合支付的费率是3‰,而微信支付商户规定费率是6‰,被微信支付风控判定为窜费率而封禁

解决3:不再通过服务商对接,小程序应用直接和微信小程序支付对接。

项目上线后。腾讯突然直接把小程序封了,没有任何预警通知,直接封。

聚合支付底层用的还是微信支付那一套系统,所以开发小程序对接使用的是微信小程序载体,那同时得遵守微信支付的规则

小程序被封后,官方发出的公告指出我们存在利用技术绕开审核的行为。并指引我们查看到以下图中内容

但询问微信内部人员,给出真正理由是:使用了聚合支付,违背了微信费率规则

 

被腾讯封的小程序,基本是捞不回来了,所以要重新申请程序重新认证,重新绑定商户号 经过微小改动,直接对接小程序支付成功上线。但过了两天,小程序它又双叒叕被封了!

踩坑4:这次他们给的原因是:小程序页面没有实质和服务的内容,不符合规则。

解决4:改用微信H5支付

这次被封,官方发出的公告依然指出我们存在利用技术绕开审核的行为。和上次给出的理由一样。但询问微信内部人员,给出真正理由是:小程序页面没有实质和服务的内容

小程序确实只有三个页面:登录页面、支付页面,支付完成页面

前后两次被封的小程序关联的都是同一个主体,微信规定,同一个商户号下的小程序被封两次后,该主体就会被拉入黑名单中

具体分步解决:

  1. 争取把主体从小黑屋中救出来
  2. 主体从黑名单中放出来后,申请新的支付载体
  3. 新的支付载体选择公众号

踩坑5:使用外部平台能力时,功能层面没有备选方案

解决5:功能层面要规划脱离依赖外部能力的备选方案

一开始没有备选方案的意识。被封后,导致业务受阻

当小程序相继两次被封后,我们意识到需要有过渡方案:预备脱离线上支付交易受阻,如何不影业务工作的方案

本应用实现的备选方案:手动切换线上线下支付交易方案,当微信支付能正常使用时,就走常规的线上交易流程。当微信支付发生意外,被封被禁后能快速启动线下支付备选方案,保障业务不受影响

三、  对接微信H5支付踩坑

踩坑6:商户需要申请H5支付权限

解决6:商户申请H5支付权限

由于之前对接小程序支付给接入准备已经走过一遍了,小程序支付不需要商户申请支付权限,只需要把商户号和公众号绑定上就行

所以没有意识到商户需要申请H5支付权限,且忽略了接入前准备-H5支付 | 微信支付商户平台文档中心最后一行小字。这直接引出了坑7,并且需要花费比较长的时间解决

踩坑7:支付域名和网站域名的ICP注册主体与申请商户号的主体必须一致

解决7:为H5应用申请域名并进行ICP备案

商户申请H5支付权限必须要遵守商户申请H5支付权限需要注意哪规则?,发现支付域名和网站域名的主体和商户号的主体不一致,由于企业内部架构的原因:

H5网页的域名的ICP注册主体是A公司

需要申请H5支付权限的商户号主体是B公司

且A公司和B公司的关系不在以下4种范围中,那只能为H5网页单独申请域名

四、  关于前端的H5支付踩坑

踩坑8:在客户端页面打开支付中间页的事件上,安卓系统和ios系统表现不同

解决8:根据业务需要自定义拼接redirect_url

  • 前情提要:

微信支付回调是异步任务,前端请求http是同步任务,但微信的支付回调我们是没办法得知触发时间

例如:当用户在支付中间页完成支付后切回业务页面,我们要查询当前订单的支付状态,不能即刻查询 借鉴其他支付交易的交互,H5页面利用的是倒计时交互实现虚拟异步

  • 小程序支付中支付中间页与客户端页面之间的跳转,在安卓、苹果、鸿蒙系统的行为表现是一致,统一监听visibilitychange事件来进行逻辑编写即可
document.addEventListener('visibilitychange', function() {

// 用户息屏、或者切到后台运行 (离开页面

if (document.visibilityState === 'hidden' ) {

// 一些业务逻辑:比如开始倒计时开始,倒计时完微信支付状态回调查询

// some code

console.log('hidden')

}

// 用户打开或回到页面

if (document.visibilityState === 'visible') {

// 一些业务逻辑

// some code

console.log('visible')

}

})
  • 而H5支付,安卓、苹果、鸿蒙系统的行为表现不一致,再通过统一监听visibilitychange事件无法满足微信支付状态回调查询
  1. 在ios系统中,企业微信浏览器上跳转微信H5支付,会换起微信应用打开H5支付控件,这样客户端页面的所有数据和状态都会保留,所以依然可以用visibilitychange事件监听

 2. 在安卓和鸿蒙系统,企微浏览器换起H5支付中间页,是直接在当前浏览器窗口替换了客户端页面,所以支付完成返回客户端页面后,页面所有的状态和原有数据都会被清空。如图,这会造成两个问题:

2.1:支付完成后回到客户端页面,查询订单状态所需要的订单信息会丢失如何保留当前订单信息 2.2:微信支付回调是异步任务,前端请求http是同步任务如何正确延时发http请求

3.自定义拼接跳转中间页的redirect_url就可以解决这两个问题,支付完成后微信会重定向回我们自定义的url,在url上加上业务需要的信息,重定向回客户端后,就可以拿到状态和数据了

// 自定义拼接redirect_url

const setToPayURL = (res:string)=>{

let redirectUrl = `${myurl}?订单id=payResultId&页面状态=1`

redirectUrl = encodeURIComponent(redirectUrl)

window.location.href = `${res}&redirect_url=${redirectUrl}`

}

五、  微信支付相关

小程序支付对接

小程序提供了获取小程序短链的开放能力,H5页面可以直接触发跳转到微信小程序,在小程序中唤起支付控件

详情查看相关文档: 获取 URL Scheme | 微信开放文档

● 前期准备:开小程序账号并认证、开商户号、然后商户号和小程序需要关联。商户号和微信小程序认证都需要绑定具有合规经营的主体。

详情查看小程序支付接入前准备:接入前准备-小程序支付 | 微信支付商户台文档中心

● 开发流程:开发指引-小程序支付 | 微信付商户平台文档中心

H5支付对接

● 前期准备:开小程序账号并认证、开商户号、然后商户号和小程序需要关联。商户号和微信小 程序认证都需要绑定具有合规经营的主体。

详情查看H5支付接入前准备:接入前准备-H5支付 | 微信支付商户平台文档中心

● 开发流程:开发指引-H5支付 | 微信支付商户平台文档中心

总结

  1. 对接第三方服务商坑总结:一旦涉及研发工作量,研发团队需尽早和第三方服务商对接
  2. 小程序支付坑总结:内容的管控比较严格,需有闭环的业务场景;费率最好不要用低于微信官方的,特别还是“免费”的
  3. H5支付坑总结:对内容管控相对宽松,但商户申请支付权限相对严格,需要域名备案、三体一致
  4. 其他:需要时刻关注平台管控;风控的规则一般不会那么明显,所以最好能找到服务机构和内部人员;功能层面要规划支付被封后的过渡方案

本文转载于:

https://juejin.cn/post/7273301807709896762

如果对您有所帮助,欢迎您点个关注,我会定时更新技术文档,大家一起讨论学习,一起进步。