更新时间：2024-10-23 18:08:00文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档1 简介在商家完成接入会员卡的基本链路后，扩展功能可满足商户会员卡的个性化营销需求和玩法，通过额外的接口配置等步骤，实现生活号、小程序和蜻蜓设备的联动。2 定制化展示会员卡模板创建接口alipay.marketing.card.template.create（会员卡模板创建接口） 提供了一系列参数帮助开发者实现会员卡的定制化展示。2.1 展示样式商户会员卡模板 默认使用列表的排版 展示自定义栏位（如下左图），商家也可以使用 宫格图标排列 的方式展示自定义栏位（如下右图）。商户通过 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 中自定义会员权益信息。2.2 会员等级商户通过在 column_info_list 的 code 参数中传入 level 可以展示给用户会员卡的等级，并通过 card_level_conf 参数配置会员卡级别信息。实现会员的分层营销，激励用户消费，提高用户和商户间的粘性。后续向用户开卡或更新用户会员等级时，仅需传入 card_level_conf#level 对应的 value 值即可。2.2.1 示例代码2.3 会员积分商户通过在 column_info_list 的 code 参数中传入 point 可以展示会员卡的积分，积分可以和权益挂钩，刺激用户消费。建议商家实时更新此项内容至支付宝，方便用户通过卡包页随时查看积分信息。2.3.1 示例代码2.4 余额信息商户可以将自己的会员卡设置为充值会员卡，商户通过在 column_info_list 的 code 参数中传入 balance 和值可以展示会员卡的余额。2.4.1 示例代码2.5 凯发k8官方网娱乐官方的联系方式商户可以将自身客服凯发k8官方网娱乐官方的联系方式展示在会员卡上，方便用户随时联系商家进行沟通反馈。商户通过在 column_info_list 的 code 参数中传入 telephone 和 value 值可以展示凯发k8官方网娱乐官方的联系方式。2.5.1 示例代码2.6 其他参数在创建会员卡模板时对应的其他参数如下图所示。3 投放会员卡至门店商家通过alipay.marketing.card.template.create（会员卡模板创建接口）创建会员卡模板时，在 shop_ids 参数传入 口碑门店、支付宝门店 的门店 id 即可配置支持使用该卡的门店信息，将会员卡与门店相互关联。完成后用户可在会员卡卡面查看支持使用的门店，还可一键导航到店消费。商家门店凯发k8官方网娱乐官方主页也可展示领取会员卡内容，方便用户从不同渠道领取会员卡。注意：仅支持投放至门店 id 长度为 28 个字符，第 10-12 位是 077 的支付宝门店，如 2020081400077000000001112200。口碑门店无此限制。3.1 应用案例会员卡展示效果门店凯发k8官方网娱乐官方首页展示效果3.2 投放渠道支持投放至 、（蚂蚁门店），需传入门店 id（非门店编号）。注意：●仅支持投放至门店 id 长度为 28 个字符，第 10-12位 是 077 支付宝门店，如 2020081400077000000001112200。口碑门店无此限制。●门店仅支持展示第一张与其关联的会员卡模板领取入口，且不支持更换。详见下文 重要规则说明 > 门店展示领卡入口。3.3 投放数量●创建模板时：通过alipay.marketing.card.template.create（会员卡模板创建接口）创建会员卡模板时，关联门店数量可以支持上万家的量级。●修改模板时：通过alipay.marketing.card.template.modify（会员卡模板修改接口）接口修改模板时，仅支持约 2000 家门店的修改跨度。3.4 重要规则说明3.4.1 会员卡展示适用门店会员卡模板设置 shop_ids 后，将自动添加 适用门店 栏位，暂不支持取消展示，仅支持修改/新增门店。商家/isv 后续可调用alipay.marketing.card.template.modify（会员卡模板修改接口）修改/新增模板支持的门店，但不支持删除已有门店及隐藏 适用门店 入口。3.4.2 门店展示领卡入口如需在门店中展示会员卡领取入口，商家在通过alipay.marketing.card.template.create（会员卡模板创建接口）创建会员卡模板时需：1传入 shop_ids（门店id）参数，用于在门店上显示会员卡领取入口；2传入 pub_channels#pub_channel 参数，并设置传递的值为 shop_detail（店铺详情页）；3传入 open_card_conf#open_card_url 参数，用于门店上点击会员卡展示区域后要跳转的页面地址。注意：●创建会员卡模板 第一次 设置 shop_ids（会员卡上架门店id）后，该门店只能显示该模板 id 的会员卡样式。●后续若想修改该门店绑定的会员卡样式。○只能通过alipay.marketing.card.template.modify（会员卡模板修改接口） 接口修改该模板 id 会员卡样式进行更新，无法进行二次绑定修改。○修改的模板 id 必须是第一次配置门店时的模板 id，如：a 模板 id 创建时配置了 b 门店，后续想修改 b 门店上显示的会员卡样式、跳转链接地址等信息，必须在模板修改接口中使用 a 模板 id。示例代码4 按会员等级展示不同卡片内容若商家需针对不同等级会员展示不同样式会员卡，推荐按如下方案开发逻辑：1商家需预先根据不同会员卡等级，创建不同卡模板样式与之对应；2当用户会员卡达到某个等级时，商家可调用alipay.marketing.card.update（会员卡更新接口）完成更新即可。该接口仅会更新指定会员卡内容，不会影响其他会员卡。○传入用户对应会员卡开卡时，接口返回会员卡 target_card_no（支付宝业务卡号）。○传入更换会员卡模板 template_id 。5 权益玩法商户会员卡底部支持商家自定义栏位，商家通过以下接口的参数拓展更多权益玩法： 权益类型涉及接口参数名称权益文案展示alipay.marketing.card.template.create（会员卡模板创建接口）column_info_list # operate_type活动页面alipay.marketing.card.template.create（会员卡模板创建接口）column_info_list # operate_type5.1 权益文案展示operate_type 的值传入 opennative 则可以引导用户打开商家配置好的二级页面，在二级页面中，商户可以定期推出营销活动，并写上相关活动的细则，引导用户参加。operate_type 的值传入 staticinfo 则可以展示固定的文案，商家可以将重要的信息和广告传入权益栏位，如商家的地址和凯发k8官方网娱乐官方的联系方式等。5.2 活动页面展示operate_type 的值传入 openweb 可以指定跳转的链接，商户可以引导用户点击进入特定营销页面。6 小程序服务直达商户会员卡还为商户在会员卡上开辟了至多 3 个卡行动点，商户可以在卡行动点上设置小程序/url 跳转链接，引导用户在会员卡复访小程序或商家页面，为商家页面引流。商户在会员卡模板创建接口alipay.marketing.card.template.create（会员卡模板创建接口） 中 card_action_list 传入指定跳转小程序页面或其他 url 地址即可引导用户前往，精准引流。6.1 卡行动点案例●用户可在 支付宝 app > 卡包 > 卡券 > 会员卡 列表页（左图）中看到小程序卡行动点信息（列表页可以展示最多 2 项小程序跳转行动点），方便用户快速使用复访小程序。●用户点击会员卡进入详情页（右图），可在所有行动点中选择使用所需功能。6.2 参数说明alipay.marketing.card.template.create（会员卡模板创建接口） 接口中涉及的字段如下：参数名称类型必填描述card_action_list templateactioninfodto[]否卡行动点配置。单张卡最多定制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 时必填。最大长度：9996.2.1 mini_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，则会在列表页前置透出按钮。6.3 配置规则说明●card_action_list 最多配置 3项，即 1 张卡最多配置 3 个按钮。●所有按钮都可以自由选择配置为小程序跳转链接或普通链接。●display_on_list=true 的行动点只能配置 0 项或 2 项，不支持 1,3 项。7 生活号联动商户会员卡还为商户在会员卡上提供了商户生活号关注入口，为商家最大程度上引流。在商家投放会员卡给用户领卡时，如商家有已上线的生活号，商家可以在alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接接口）中传入 follow_app_id 参数，在用户领卡页面展示“关注生活号”文案。用户勾选“关注生活号”选项后，即可在领卡的同时关注商家的生活号。8 iot 多端投放商家在成功接入商户会员卡功能后，如果商家有蜻蜓机具，商家可以在蜻蜓机具上投放商户会员卡。商家在 进行配置，配置完成后，满足条件的消费者使用蜻蜓支付时，即可领取会员卡，详细接入指南可参考 ，领取页面如下图所示。9 商户动态发码商家/isv 如需在用户在支付宝卡包中打开会员卡时，展示自行生成的动态二维码/条形码，可根据 商户动态发码 指引集成动态发码功能。
