指引说明
1.1 简介
该接入指引,用于指导接入商户如何在自有APP/外部H5上进行小程序跳转支付。
<font style="color:#DF2A3F;">相关说明:</font>
- <font style="color:#DF2A3F;">微信支付宝不对间联场景提供APP/H5支付,因此本指引提及的APP/H5支付,实际为跳转到小程序,然后进行小程序支付。</font>
- <font style="color:#DF2A3F;">目前仅支持微信小程序跳转支付(H5/APP版本)。</font>
1.2 应用场景
商户有基于移动端APP、H5、支付宝/微信小程序等业务平台,需要使用支付宝/微信支付,可以通过小程序跳转支付完成支付。
1.3 名词解释
| 名词 | 解释 |
|---|---|
| 交易发起场景 | 商户客户端发起交易的场景,目前支持H5/APP |
| 支付小程序 | 交易发起后跳转到支付小程序,用户在支付小程序内完成支付 |
| 跳转方式 | 跳转方式特指,用户在支付小程序完成支付后,跳转到商户指定的目标场景的方式 |
| └ 回跳 | 从哪里来回哪里去。用户支付完成/取消支付时,返回交易发起场景 |
| └ 内跳 | 哪都不去。用户支付完成/取消支付时,留在支付小程序中并打开商户自定义页面 |
| └ 外跳 | 用户支付完成/取消支付时,关闭支付小程序,并打开另一个小程序或H5页面(在支付宝/微信APP内) |
| └ 关闭小程序 | 用户支付完成/取消支付时,关闭支付小程序,展示支付宝/微信首页(由于安卓系统特殊性,小程序是独立作为APP唤起,直接关闭小程序会直接展示交易发起场景,用户体验更好) |
1.4 跳转方式
付款方在支付小程序完成支付后,跳转到商户指定的目标场景的方式。
| 跳转方式 | 目标场景 | 微信 |
|---|---|---|
| 回跳 | APP | 支持 |
| 小程序 | 支持 | |
| 内跳 | H5(微信/支付宝小程序内) | 支持 |
| 外跳 | 小程序 | 支持 |
| H5(支付宝小程序内) | 支持 | |
| 关闭小程序 | / | 支持 |
1.5 支付完成后跳转携带的参数
| 惠商订单号 | orderNo | |
|---|---|---|
| 订单状态 | orderStatus | 0-支付成功;1-支付失败;2-取消支付 |
| 响应信息 | msg |
起跳场景
3.1 APP场景
3.2 小程序场景
跳转模式
4.1 回跳模式说明
iOS系统支持识别 URL Scheme,可在短信等应用场景中直接通过Scheme跳转小程序。Android系统不支持直接识别 URL Scheme,用户无法通过 Scheme 正常打开小程序,开发者需要使用 H5 页面中转,再跳转到 Scheme 实现打开小程序,跳转代码示例如下:
Location.href ='weixin://dl/business/?t= TICKET'
该跳转方法可以在用户打开 H5 时立即调用,也可以在用户触发事件后调用.
