本指引适用于从服务商自制商户静态码牌（H5或微信小程序模式），用户使用微信APP扫码进入码牌收银台页面，用户选择云闪付，调 4.1.2 JSAPI支付 接口下单，拉起云闪付APP或微信小程序完成付款。
对应业务接入指引 2.12.

1 微信小程序模式

指服务商自制码牌为微信小程序码牌。

1.1 前端页面展示

1.2 跳转云闪付微信小程序说明

1.3 小程序跳转示例

https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html

https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onAppShow.html

建议判断为从云微小程序返回后，再调用wx.offAppShow 移除监听切前台事件，以免用户手动将商户小程序切后台再打开导致误判。

2 云闪付APP模式

指指服务商自制码牌为微信内H5。

2.1 前端展示

2.2 链接拼接

点击付款按钮跳转的目标链接，需按如下方式，进行链接拼接：
1）跳转参数：
组装方法为{"dest":"不加协议头的订单唯一标识（redirectUrl）
","host":"html"}，比如某次接收到的唯一标识（redirectUrl）为：
https://qr.95516.com/14538200/87001002101，得到：
{"dest":"qr.95516.com/14538200/87001002101","host":"html"}

2）base64：
将上述跳转参数base64，得到：
eyJkZXN0IjoicXIuOTU1MTYuY29tLzE0NTM4MjAwLzg3MDAxMDAyMTAxIiwiaG9zdCI6Imh0bWwifQ==

3）urlencode：
将上述字符串urlencode，得到：eyJkZXN0IjoicXIuOTU1MTYuY29tLzE0NTM4MjAwLzg3MDAxMDAyMTAxIiwiaG9zdCI6Imh0bWwifQ%3D%3D

4）形成最终跳转链接：
将上述字符串按如下格式拼接，得到：
https://base.cup.com.cn/s/wl/WebAPP/helpAgree/page/share/shareH5ToNative.htmlparams=eyJkZXN0IjoicXIuOTU1MTYuY29tLzE0NTM4MjAwLzg3MDAxMDAyMTAxIiwiaG9zdCI6Imh0bWwifQ%3D%3D

将上述链接，作为按钮的最终跳转链接。

3 链接拼接（H5 模式）

点击机构h5页面付款按钮跳转银联页面的目标链接，需按如下方式进行链接拼接：
跳转链接由跳转路径和跳转参数组成，${跳转路径}?params=${跳转参数串}
跳转路径：https://base.cup.com.cn/s/wl/WebAPP/helpAgree/page/sharePay/${随机字符串}

1）组装跳转参数：

组装方法为

{"dest":"不加协议头的订单唯一标识（redirectUrl）","host":"html","isNeedWeApp":"1","weAppId":"云闪付微信小程序appid","weAppPath":"跳转云闪付微信小程序目标页面的路径和参数","weAppEnvVersion":"要打开的小程序环境"}

表3.6.1 跳转参数说明

参数	说明
weAppId	云闪付微信小程序的appid（固定填写wx3cbe919f36710d1c）
weAppPath	打开的路径，页面的路径固定填写 `/pages/CQPApplet/index`，其参数为 service 和 type，参数与路径之间使用 ? 分隔，参数键与参数值用 = 相连，不同参数用 & 分隔；如 `"path?key=value&key2=value2"`，service 和 type 具体参考表3.6.2 weAppPath参数说明。
weAppEnvVersion	要打开的小程序版本： `"trial"`：表示体验版 `"release"`：生产版
isNeedWeApp	固定填写 `"1"`：代表未安装云闪付客户端时唤起云微小程序
host	`"html"`
dest	不加协议头的订单唯一标识（redirectUrl）
随机字符串	每笔交易随机生成，6位，数字+字母、纯数字、纯字母均可

表3.6.2 weAppPath 参数说明

参数key 说明

service 要跳转的地址，（注意：如果跳转的地址中带有参数，需要对整个 service 值进行encodeURIComponent）
其值为：
/pagesPay/payDetails/index?certificate=${redirectUrl}&source=${source}&entryAppId=${appId}&isLocationAuthRequirid=${isLocationAuthRequirid}
其中 redirectUrl 和 source 以及 isLocationAuthRequirid 需要接入方按照实际补全，具体说明如下：
source:取值："02"-代表由公众号调起，
redirectUrl:指二维码订单推送接口中银联应答的redirectUrl，原样取出填写在此处
entryAppId: 机构/服务商的微信公众号appId，需与二维码订单推送接口中 thirdAppId 的内容填写一致。
isLocationAuthRequirid："00"- 代表不需要提示用户获取地理位置授权；"01"-代表需要提示用户获取地理位置授权，不传默认"00"。为避免因用户未进行地理位置授权而无法享受地区营销的情况，当该笔交易在机构收银台提示有云闪付优惠情况下，应上送取值"01"。若交易未在机构收银台向用户提示云闪付优惠，应上送取值"00"。该字段取值不应固定写死，需根据实际上送。
注意：service 需要做整体的 URL 编码

type 使用固定的 applet 值

参数key	说明
service	要跳转的地址，（注意：如果跳转的地址中带有参数，需要对整个 service 值进行encodeURIComponent）其值为： `/pagesPay/payDetails/index?certificate=${redirectUrl}&source=${source}&entryAppId=${appId}&isLocationAuthRequirid=${isLocationAuthRequirid}` 其中 redirectUrl 和 source 以及 isLocationAuthRequirid 需要接入方按照实际补全，具体说明如下： source:取值："02"-代表由公众号调起， redirectUrl:指二维码订单推送接口中银联应答的redirectUrl，原样取出填写在此处 entryAppId: 机构/服务商的微信公众号appId，需与二维码订单推送接口中 thirdAppId 的内容填写一致。 isLocationAuthRequirid："00"- 代表不需要提示用户获取地理位置授权；"01"-代表需要提示用户获取地理位置授权，不传默认"00"。为避免因用户未进行地理位置授权而无法享受地区营销的情况，当该笔交易在机构收银台提示有云闪付优惠情况下，应上送取值"01"。若交易未在机构收银台向用户提示云闪付优惠，应上送取值"00"。该字段取值不应固定写死，需根据实际上送。注意：service 需要做整体的 URL 编码
type	使用固定的 applet 值

比如跳转路径中的随机字符串为 abc123，某次接收到的唯一标识（redirectUrl）为：https://qr.95516.com/14538200/87001002101，机构/服务商的公众号appId为wx123sufieofpdufiw，isLocationAuthRequirid字段因机构收银台未提示云闪付优惠而取00：

参数	说明
weAppId	`"wx3cbe919f36710d1c"`
weAppPath	`'/pages/CQPApplet/index?service=${encodeURIComponent(`/pagesPay/payDetails/index?certificate={"02"}&entryAppId={"00"})}&type=applet'`
weAppEnvVersion	`"release"`
isNeedWeApp	`"1"`
host	`"html"`
dest	`"qr.95516.com/14538200/87001002101"`

得到：

{"dest":"qr.95516.com/14538200/87001002101","host":"html","isNeedWeApp":"1","weAppId":"wx3cbe919f36710d1c","weAppPath":"/pages/CQPApplet/index?service=%2FpagesPay%2FpayDetails%2Findex%3Fcertificate%3Dhttps%3A%2Fqr.95516.com%2F14538200%2F87001002101%26source%3D02%26entryAppId%3Dwx123sufieofpdufiw%26isLocationAuthRequirid%3D00&type=applet","weAppEnvVersion":"release"}

2）base64：

将上述跳转参数 base64，得到：eyJkZXN0IjoicXIuOTU1MTYuY29tLzE0NTM4MjAwLzg3MDAxMDAyMTAxIiwiaG9zdCI6Imh0bWwiLCJpc05lZWRXZUFwIjoiMSIsIndlQXBwSWQiOiJ3eDNjYmU5MTlmMzY3MTBkMWMiLCJ3ZUFwcGF0aCI6Ii9wYWdlcy9DUVBQYXBwbGV0L2luZGV4P3NlcnZpY2U9JTNGcGFnZXNQYXklMkZwYXlEZXRhaWxzJTNGaW5kZXglM0NjZXJ0aWZpY2F0ZSUzREh0dHBzJTNBLyUyRnFyLjk1NTE2LmNvbSUyRjE0NTM4MjAwJTNFOODcwMTAwMjEwMSUyNnNvdXJjZSUzRDAyJTI2ZW50cnlBcHBJZCUzRnd4MTIzc3VmaWVvZnBkdWZpdwUyNmlzTG9jYXRpb25BdXRoUmVxdWlyZCUzRDAwJnR5cGU9YXBwbGV0Iiwid2VBcHBFbnZWaXJzaW9uIjoicmVsZWFzZSJ9

3）urlencode：

将上述字符串 urlencode，得到：eyJkZXN0IjoicXIuOTU1MTYuY29tLzE0NTM4MjAwLzg3MDAxMDAyMTAxIiwiaG9zdCI6Imh0bWwiLCJpc05lZWRXZUFwIjoiMSIsIndlQXBwSWQiOiJ3eDNjYmU5MTlmMzY3MTBkMWMiLCJ3ZUFwcGF0aCI6Ii9wYWdlcy9DUVBQYXBwbGV0L2luZGV4P3NlcnZpY2UlM0QlMkZwYWdlc1BheSUyRnBheURldGFpbHMlMkZpbmRleCUzRGNlcnRpZmljYXRlJTNESHR0cHMlM0ElMkYlMkZxci45NTUxNi5jb20lMkYxNDUzODIwMCUyRjg3MDAxMDAyMTAxJTI2c291cmNlJTNEMDIlMjZlbnRyeUFwcElkJTNEd3gxMjNzdXZpZW9mcGR1Zml3JTI2aXNMb2NhdGlvbkF1dGhSZXF1aXJpZCUzRDAwJnR5cGU9YXBwbGV0Iiwid2VBcHBFbnZWaXJzaW9uIjoicmVsZWFzZSJ9

4）形成最终跳转链接：

将上述字符串按如下格式拼接，得到：https://base.cup.com.cn/s/wl/WebAPP/helpAgree/page/sharePay/abc123?params=eyJkZXN0IjoicXIuOTU1MTYuY29tLzE0NTM4MjAwLzg3MDAxMDAyMTAxIiwiaG9zdCI6Imh0bWwiLCJpc05lZWRXZUFwIjoiMSIsIndlQXBwSWQiOiJ3eDNjYmU5MTlmMzY3MTBkMWMiLCJ3ZUFwcGF0aCI6Ii9wYWdlcy9DUVBQYXBwbGV0L2luZGV4P3NlcnZpY2UlM0QlMkZwYWdlc1BheSUyRnBheURldGFpbHMlMkZpbmRleCUzRGNlcnRpZmljYXRlJTNESHR0cHMlM0ElMkYlMkZxci45NTUxNi5jb20lMkYxNDUzODIwMCUyRjg3MDAxMDAyMTAxJTI2c291cmNlJTNEMDIlMjZlbnRyeUFwcElkJTNEd3gxMjNzdXZpZW9mcGR1Zml3JTI2aXNMb2NhdGlvbkF1dGhSZXF1aXJpZCUzRDAwJnR5cGU9YXBwbGV0Iiwid2VBcHBFbnZWaXJzaW9uIjoicmVsZWFzZSJ9

F.17 银联二维码云微支付开发指引

1 微信小程序模式#

1.1 前端页面展示#

1.2 跳转云闪付微信小程序说明#

1.3 小程序跳转示例#

2 云闪付APP模式#

2.1 前端展示#

2.2 链接拼接#

3 链接拼接（H5 模式）#

1）组装跳转参数：#

表3.6.1 跳转参数说明#

表3.6.2 weAppPath 参数说明#

2）base64：#

3）urlencode：#

4）形成最终跳转链接：#