产品文档 综合收付 小程序跳转支付

小程序跳转支付

指引说明

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
订单状态orderStatus0-支付成功;1-支付失败;2-取消支付
响应信息msg

起跳场景

3.1 APP场景

APP跳转小程序(iOS版本)

APP跳转小程序(Android版本)

3.2 小程序场景

小程序调用教程

跳转模式

4.1 回跳模式说明

iOS系统支持识别 URL Scheme,可在短信等应用场景中直接通过Scheme跳转小程序。Android系统不支持直接识别 URL Scheme,用户无法通过 Scheme 正常打开小程序,开发者需要使用 H5 页面中转,再跳转到 Scheme 实现打开小程序,跳转代码示例如下:

Location.href ='weixin://dl/business/?t= TICKET'

该跳转方法可以在用户打开 H5 时立即调用,也可以在用户触发事件后调用.