来自:程序通事
前言
最近由于业务需求,需要开发付款码功能,该接口底层将会聚合市面上主流钱包 APP 的付款码功能,如微信支付,支付宝支付。
ps:付款码支付别称有很多,如微信支付端支付产品为付款码支付(之前的文档叫做刷卡支付),而支付宝端产品为当面付-条支付,而有些文档会成为二维码被扫支付。
下文统一使用微信的定义方式,统称为付款码支付。
可能有些同学对于付款码支付这个听起来很陌生,其实这个功能我们可能每天都在被使用。
像我们在便利店买个早饭,最后结账时,使用支付宝/微信支付付款。收银员会让我们展示支付宝/微信付款码,然后使用扫码枪获取此码,最后上送给微信/支付宝服务端完成一次扣款。
以支付宝为例,具体用户端支付流程如下:
![](https://i-blog.csdnimg.cn/blog_migrate/28af81e1283c66a398a84588bb4eb6c6.png)
付款码支付后台调用流程如下:
![](https://i-blog.csdnimg.cn/blog_migrate/f5e7770c46f13e928d87e12cc31d3d7e.png)
付款码支付详细版流程
微信/支付宝付款码支付调用流程大同小异,官网写的都比较清楚,这里直接用支付宝的官网的流程。
![](https://i-blog.csdnimg.cn/blog_migrate/8bc9bce0add06cd02ce4a5350c838cd3.png)
从上面的流程可以看到,付款码支付可以说是一个同步的接口,即接口同步返回扣款结果,无需通过另外异步通知获取结果。
不过这里我们需要注意,由于涉及安全风控等问题,付款码支付过程用户端可能需要输入密码确认支付,此时付款码接口将会返回等待用户支付。
接入时务必正确判断返回信息,若返回以下结果,代表此时用户正在输入密码。
微信支付: err_code=USERPAYING 或 err_code=SYSTEMERROR
支付宝:code=10003 或 code=20000
微信付款码支付在以下情况需要输入密码二次确认。
![](https://i-blog.csdnimg.cn/blog_migrate/cf65300b6d8bb4b63d2b4916a5f14f10.png)
支付宝官方文档暂未找到相关规则,经过测试当支付金额大于 2000 ,需要输入密码。如果有熟悉其他验密规则的同学,可以在评论区留言一下。
另外一点需要注意的是,微信/支付宝其他支付接口,支付成功之后,微信/支付宝服务端将会发送消息通知支付结果。但是付款码不一样,该接口是不会有消息通知。
所以如果付款码支付若返回等待用户输入密码,商家后台服务必须定时调用调用微信支付/支付宝查询接口,获取支付结果。
![](https://i-blog.csdnimg.cn/blog_migrate/bc5f5955b366ad54431166cd9c1a9fa4.png)
撤销支付
如果在一段时间内比如 30s,轮询查询支付结果返回都是等待用户支付,或者支付交易过程返回失败或支付系统超时,这两种情况官方文档都是建议立刻调用撤销接口撤销交易。
如果此订单用户支付失败,撤销接口将会订单关闭;如果用户支付成功,撤销接口将会订单资金退还给用户。
也就是说撤销支付接口功能上等同与关闭订单加上退款。虽然撤销也具有退款功能,但是两者存在比较大的区别:
支付类型限制
微信/支付宝撤销支付仅能撤销付款码支付类型的订单,而退款可以支持多种支付类型的订单。
退款金额
撤销接口只能是全额退款,而退款接口支持传入金额,可以全额退款,也可以部分退款。
时间限制
撤销接口时间限制比较短,比如微信支付撤销支持 7 天内的订单,而支付宝撤销接口仅支持当天的订单。
但是退款接口可以支持较长时间订单退款,比如微信支付退款支持一年内的订单,而支付宝仅支持 3 个月内订单。
基于以上区别,其他正常支付的单如需实现相同功能请调用退款接口,官方文档建议仅在异常的情况下才建议调用撤销支付接口。
另外再说一点,有些地方这个功能接口称为冲正接口,如下面工商二维码支付。
![](https://i-blog.csdnimg.cn/blog_migrate/c9b1d1a550bd31cda3034c901bbf6311.png)
实际上提供的功能与微信/支付宝撤销类似,这里需要各家支付公司提供文档具体研究。
撤销支付相关问题
由于撤销支付,可能导致退款,也可能关闭订单,接入之前一直有些问题弄不清楚,在官方文档处也没有查询到任何资料,没办法只好实测验证相关问题。
由于规定,支付机构不能直连微信/支付宝,所以以下测试基于银联微信/支付宝通道。
银联提供的接口与直连微信/支付宝存在些许差别,但是主要功能一样。
重复撤销
通过实测,微信/支付宝撤销接口幂等实现,重复撤销返回结果一致。
不过需要注意需要正确判断撤销的返回结果。
比如微信撤销接口成功判断还需要结合 recall
字段,支付宝也有类似字段。
![](https://i-blog.csdnimg.cn/blog_migrate/a4b7341639ac0ec9dec7553ca004c8eb.png)
订单状态
微信/支付宝订单状态处理不太一致,微信订单状态比较复杂:
![](https://i-blog.csdnimg.cn/blog_migrate/dbd4e5b33376bb0e41d360d04901ac60.png)
也就是说,付款码订单一旦被撤销成功,再次查询订单,状态将会返回为已撤销(REVOKED)。
另外微信对于付款码支付订单有限制,是无法调用关闭订单接口关闭订单,所以在付款码的场景中,是不存在订单状态为 CLOSED—已关闭。
接下来说下支付宝的状态,支付宝文档没要给出类似的订单状态机,我根据官方一些文档,以及一些测试结果总结出下方订单状态图。
![](https://i-blog.csdnimg.cn/blog_migrate/102e925fbceb5cf6e45399ae0be73ebf.png)
所以支付宝的付款码订单一旦撤销成功,再次查询原单状态将会返回 TRADE_CLOSED。
对账文件数据
当天产生交易之后,次日我们需要拉取微信/支付宝对账文件,逐一核对数据,防止少账,多账问题。
对账设计流程可以参考之前写过的文章:
微信/支付宝对账文件只会记录交易成功的订单,所以未支付的订单被撤销是不会出现在对账文件中。但是如果支付成功了,然后又被撤销成功,将会在对账文件中产生两笔记录,一笔正交易,一笔反向退款记录。
正交易与普通的退款的记录都比较好识别,一般可以使用我们上送给微信支付宝订单号。但是撤销导致退款记录,我们无法仅用一个单号识别,我们需要结合另外的字段区分判断。
微信对账文件撤销产生那笔退款,交易状态为 REVOKED,所以我们可以采用商户订单号加交易状态识别出一条记录是否为撤销产生退款记录。
![](https://i-blog.csdnimg.cn/blog_migrate/f7fa0114fbc6a377949088f0b0c836e1.png)
上面银联订单号可以当做是微信支付宝内部产生订单号
支付宝对账文件比较麻烦,撤销产生的退款记录不能跟微信根据交易状态区分。从对账文件上看支付宝撤销产生退款与普通退款接口产生退款记录是一样的。
![](https://i-blog.csdnimg.cn/blog_migrate/294066a8213e9b7e8e9205968febbd6f.png)
仔细研究对账文件可以发现一些区别,撤销导致退款记录退款批次与正交易支付宝内部订单号是一致的。而正常退款记录,退款批次号是由商户自己上送的。所以我们可以以此筛选出撤销产生的退款记录。
撤销失败
极端情况下,有可能产生多次撤销都失败的奇葩情况,那怎么办?
这种情况下就不用往系统自动处理方向考虑了,通过线下人工介入处理吧,毕竟这种概率太低了。
引用知乎 @天顺 的文章中一句话:
很多时候人工保障比你动脑筋想异常中的异常如何系统自动处理来得反而高效和低成本
这句话大家仔细品,越品越有道理!
特别推荐一个分享架构+算法的优质内容,还没关注的小伙伴,可以长按关注一下:
长按订阅更多精彩▼
如有收获,点个在看,诚挚感谢