扩展功能 -凯发app官方网站更新时间：2022-06-28 16:10:44收藏我的文档设置返回文档简介在商家完成接入会员卡的基本链路后，扩展功能可满足商户会员卡的个性化营销需求和玩法，通过额外的接口配置等步骤，实现生活号、小程序和蜻蜓设备的联动。小程序服务直达商户会员卡为商家在会员卡上开辟了至多 3 个卡行动点，商家可以在卡行动点上设置小程序/url 跳转链接，引导用户在会员卡复访小程序或商家页面，为商家页面引流。商家在 alipay.marketing.card.template.create（会员卡模板创建接口）中 card_action_list 传入指定跳转小程序页面或其它 url 地址即可引导用户前往，精准引流。卡行动点案例●用户可在 支付宝客户端 > 卡包 > 卡券 > 会员卡 列表页（左图）中看到小程序卡行动点信息（列表页可以展示最多 2 项小程序跳转行动点），方便用户快速使用复访小程序。●用户点击会员卡进入详情页（右图），可在所有行动点中选择使用所需功能。 卡行动点字段开发者可在 alipay.marketing.card.template.create（会员卡模板创建接口）通过如下参数配置卡行动点。参数名称类型必填描述card_action_listtemplateactioninfodto[]否卡行动点配置。单张卡最多定制3个行动点。如果各项的配置内容完全一样，展示时会进行去重。行动点：即用户可点击跳转的区块，类似按钮控件的交互。l codestring是行动点业务 code，商家自定义。示例值：to_clock_in最大长度：32l textstring是行动点展示文案。示例值：打卡最大长度：6l url_typestring否跳转链接类型，默认为 url。支持：●url：对应填写 url 参数，支持 http(s) 和支付宝 schema 地址等。●miniappurl：对应填写 mini_app_url 参数，跳转至指定的支付宝小程序页面。最大长度：32l urlstring特殊可选行动点跳转链接，当 url_type 为 url 或不填时必填。最大长度：1024l mini_app_urltemplateactionminiappurldto特殊可选小程序页面跳转链接。当 url_type 取 miniappurl 时必填。最大长度：999mini_app_url 对应的字段配置项参数名称具体类型必填描述mini_app_idstring是小程序 appid。示例值：2018xxxxxxx最大长度：20mini_page_paramstring否指定小程序页面，不填则默认跳转至对应小程序凯发k8官方网娱乐官方首页。示例值：pages/index/index最大长度：20mini_query_paramstring否query 参数，商家自定义传参，填入值将以 query 为参数名提交至指定小程序页面。示例值：key1=val1&key2=val2最大长度：50display_on_liststring否行动点按钮是否在列表页展示，true 或 false，不填则默认false；列表页可以配置展示最多2项小程序跳转行动点。示例值：false最大长度：5说明：●mini_page_param 和 mini_query_param 分别对应小程序跳转 scheme 中的 page 和 query 参数。●display_on_list 字段设置行动点在列表页前置透出（支付宝客户端32版本及以上）。●display_on_list 字段设置为 true，则会在列表页前置透出按钮。配置规则说明●card_action_list 最多配置 3 项，即 1 张卡最多配置 3 个按钮。●所有按钮都可以自由选择配置为小程序跳转链接或普通链接。●display_on_list=true 的行动点只能配置 0 项或 2 项，不支持 1、3 项。会员卡模板定制化展示●商家可通过 alipay.marketing.card.template.create（会员卡模板创建接口）提供了一系列参数帮助开发者实现会员卡的定制化展示。●也支持登录 支付宝商家中心 > 运营中心 > ，进行可视化的会员卡模板定制化展示样式配置。展示样式商户会员卡模板 默认使用列表的排版 展示自定义栏位（如以下左图中所示），商家也可以使用 宫格图标排列 的方式展示自定义栏位（如以下右图中所示）。商家通过 template_style_info#column_info_layout 参数来控制如下栏位展示样式。样式支持：●list：栏位以列表的形式展示，默认为 list。●grid：栏位以图标宫格的样式展示；展示的图标需要开发者将图标素材通过 alipay.offline.material.image.upload（上传门店照片和视频接口）上传，返回得到图标的 image_id，将得到的 image_id 的值传入到 alipay.marketing.card.template.create（会员卡模板创建接口） column_info_list 中的 icon_id 参数中。注意：列表与宫格展示形式在权益信息上存在如下区别：●list（列表展示）样式 会员权益 可通过权益信息 template_benefit_info 参数配置会员卡权益说明。●grid（宫格展示）样式不展示 template_benefit_info 参数配置的权益说明，需要在 column_info_list#code 中自定义会员权益信息。会员等级商家通过在 column_info_list 的 code 参数中传入 level 可以展示给用户会员卡的等级，并通过 card_level_conf 参数配置会员卡级别信息。实现会员的分层营销，激励用户消费，提高用户和商家之间的粘度。后续向用户开卡或更新用户会员等级时，仅需传入 card_level_conf#level 对应的 value 值即可。示例代码会员积分商家通过在 column_info_list 的 code 参数中传入 point 可以展示会员卡的积分，积分可以和权益挂钩，刺激用户消费。●建议商家实时更新此项内容至支付宝，方便用户通过卡包页随时查看积分信息●当商家将积分更新消息通知支付宝后，用户可在支付宝端内收到积分更新消息通知示例代码余额信息●商家的会员卡为充值会员卡时，商家可通过在 column_info_list 的 code 参数中传入 balance 和值，用户可在会员卡中查看余额信息●当商家将余额变动消息通知卡包时，用户可在支付宝端内收到余额变动的通知消息示例代码凯发k8官方网娱乐官方的联系方式商家可以将自身客服凯发k8官方网娱乐官方的联系方式展示在会员卡上，方便用户随时联系商家进行沟通反馈。商家通过在 column_info_list 的 code 参数中传入 telephone 和 value 值可以展示凯发k8官方网娱乐官方的联系方式。示例代码按会员等级展示不同卡片内容若商家需针对不同等级会员展示不同样式会员卡，推荐按如下方案开发逻辑：1商家需预先根据不同会员卡等级，创建不同卡模板样式与之对应；2当用户会员卡达到某个等级时，商家可调用 alipay.marketing.card.update（会员卡更新接口）完成更新即可，该接口仅会更新指定会员卡内容，不会影响其它会员卡。○传入用户对应会员卡开卡时，接口返回会员卡 target_card_no（支付宝业务卡号）。○传入更换会员卡模板 template_id 。动态会员码商家/服务商如需在用户在支付宝卡包中打开会员卡时，展示自行生成的动态二维码/条形码，可根据 商户动态发码 指引集成动态发码功能。其它参数在创建会员卡模板时对应的其它参数如下图所示：iot 刷脸开卡除了支持通过支付宝端内引导用户领卡入会，商家会员卡产品也支持，通过线下刷脸支付机具，引导用户进行刷脸入会领卡，可查看 刷脸会员登录与支付。
