商家会员卡跳转小程序 -凯发app官方网站

更新时间：2022-12-21 10:47:01

贡献者

我的文档

设置

商家会员卡中想接入小程序，点击会员卡中的按钮跳转到对应的小程序应用中。

商家会员卡栏位跳转小程序

配置说明

会员卡模板栏位跳转需要在创建接口中进行参数配置：

●

column_info_list 中的 operate_type 值设为 openweb。

●

more_info 中的 url 设置跳转协议：从会员卡跳转至小程序使用

scheme 页面内跳转协议

。

//跳转小程序scheme 页面协议

alipays://platformapi/startapp?appid=xxx&page=x/yz&query=xx=xx

对应相应的 appid 和 page 名称即可，query 携带的启动参数必须进行 urlendecode 否则只能获取第一个参数。

参数	描述	示例
appid	小程序 appid。	20170713077xxxxx
page	小程序跳转的页面。如果不设置，默认为跳转至凯发k8官方网娱乐官方首页。	pages/user/user
query	启动参数，内容按照格式为：参数名=参数值&参数名=参数值… 之后 encode。	xx=xx

示例代码

java 拼接入参示例

\\"column_info_list\\":[{" "

\\"code\\":\\"benefit_info\\"," "\\"operate_type\\":\\"openweb\\"," //operate_type值设为openweb"\\"title\\":\\"会员专享\\"," "\\"value\\":\\"80\\"," "\\"more_info\\":{" "\\"title\\":\\"会员专享权益\\"," "\\"url\\":\\"alipays://platformapi/startapp?appid=xxx&page=x/yz\\"," //url设置scheme跳转协议,appid和page需修改为开发者自己的小程序信息"\\"params\\":\\"{}\\"," "

\\"descs\\":[" "

\\"会员生日7折\\"" "

]" "

}," "\\"icon_id\\":\\"1t8pp00at7eo9noajkmr3aaaacmaaqec\\"," "\\"tag\\":\\"热门\\"," "\\"group_title\\":\\"校园助手\\"" "

}],"

商家会员卡行动点（按钮）关联小程序

配置说明

卡行动点（按钮）配置在创建会员卡模板接口（

alipay.marketing.card.template.create

）的 card_action_list（卡行动点）配置，对应如下。

参数名称	具体类型	必填	最大长度	示例值	描述
code	string	是	32	to_clock_in	行动点业务 code，商家自定义。
text	string	是	6	打卡	行动点展示文案。
url_type	string	否	20	miniappurl	跳转链接类型。若要跳转至指定的支付宝小程序页面，该参数固定为 miniappurl，对应需填写 mini_app_url 参数。
mini_app_url	templateactionminiappurldto	否	999	-	小程序页面跳转链接，当 url_type 取 miniappurl 时必填。

小程序页面跳转链接配置项 mini_app_url 对应的字段配置项如下：

参数名称	具体类型	必填	最大长度	示例值	描述
mini_app_id	string	是	20	2018xxxxxxx	小程序 appid。
mini_page_param	string	否	20	xxxxxxxx	指定小程序页面，不填则默认跳转至对应小程序凯发k8官方网娱乐官方首页。
mini_query_param	string	否	50	abcxxxxxx	query 参数，商家自定义传参，填入值将以 query 为参数名提交至指定小程序页面。
display_on_list	string	否	5	false	行动点按钮是否在列表页展示，true 或 false，不填则默认 false；列表页可以配置展示最多2项小程序跳转行动点。

●

card_action_list 单张卡最多定制4个行动点，如果各项的配置内容完全一样，展示时会进行去重。

●

其中 mini_page_param 和 mini_query_param 分别对应

小程序scheme链接介绍

中的 page 和 query 参数。

●

display_on_list 字段设置行动点设置为 true，在列表页前置透出（支付宝客户端32版本及以上）。

●

列表页可以同时配置配置小程序跳转链接或普通链接。

●

列表页配置小程序跳转行动点，display_on_list=true 的行动点只能配置 0 项或 2 项，不支持1,3,4项；否则报错 invalid_parameter（参数有误。卡行动点 display_on_list 只能配置 2 项或 0 项，而当前配置了 1 项）。

示例代码

json 入参示例

java 拼接入参示例

展示效果

display_on_list=true 时。

会员卡内显示效果如下。

相关问题