对接文档校园卡更新样式 新版本样式只在客户端版本10.1.0及以上支持,样式展示兼容性问题需用户主动升级支付宝客户端。
对接 整个更新流程分为两部分: 1. 卡面展示学生信息 2. 新的“去买单”“刷门禁”按钮样式
1. 卡面展示学生信息
1.1 卡模板打开信息展示开关
对于新接入校园卡的高校,调用卡模板创建接口alipay.marketing.card.template.create;
对于线上现存的高校校园卡,调用卡模板更新接口alipay.marketing.card.template.modify;
调用前请在先在测试卡模板上验证。 视情况,需添加/修改的配置如下:
传参template_style_info <https://docs.open.alipay.com/api_5/alipay.marketing.card.template.create> 下的字段:
front_text_list_enable 是否在卡面展示学生信息文案,传入true,即展示个人信息文案,默认为false
front_image_enable 是否在卡面展示学生信息图片,传入true,即展示个人信息图片,默认为false
以上配置完成即打开了卡面展示信息的开关,接下来需更新校园卡传入学生信息。
1.2 校园卡传入学生信息
传入学生信息也分为以下两种情况:
校园卡开卡时传入,调用alipay.marketing.card.open; 线上现存的校园卡更新,调用alipay.marketing.card.update;
调用前请在先在测试卡模板下开卡、更新验证。 视情况,需在以下字段传入学生信息:
传参card_ext_info <https://docs.open.alipay.com/api_5/alipay.marketing.card.open> 下的字段:
front_text_list 定义:卡面展示的个人信息文案(列表) 类型:复杂类型,新增模型定义CardFrontTextDTO
CardFrontTextDTO:卡面展示文案信息模型 – label:String类型,可空,左侧标签值,如"姓名" – value:String类型,可空,右侧键值,如“李国兴”
front_image_id 定义:卡面展示的个人信息图片id 需预先通过接口alipay.offline.material.image.upload上传图片得到图片id 类型:String类型,可空
2 新的“去买单”“刷门禁”按钮样式
新按钮在客户端版本10.1.0及以上才能正常展示,低版本客户端不展示。
按钮样式的更新比较简单,只需在卡模板上配置按钮(行动点);
对于新接入校园卡的高校,调用卡模板创建接口alipay.marketing.card.template.create;
对于线上现存的高校校园卡,调用卡模板更新接口alipay.marketing.card.template.modify;
同样:调用前请在先在测试卡模板上验证。 传参card_action_list <https://docs.open.alipay.com/api_5/alipay.marketing.card.template.create> 字段:
card_action_list 卡行动点(按钮)配置; 行动点,即用户可点击跳转的区块,类似按钮控件的交互; 单张卡模板最多定制4个行动点! 类型:复杂类型,新增模型定义TemplateActionInfoDTO – code:String类型,必填,行动点业务CODE,自定义,如“TO_PAY“ – text:String类型,必填,行动点展示文案,如“刷门禁” – url:String类型,必填,行动点跳转链接,如"https://merchant.ali.com/ee/clock_in.do <https://merchant.ali.com/ee/clock_in.do> "
注意,对于线上现存的高校校园卡,更新卡模板时,1次调用时需完成以下两处配置改动: 移除column_info_list中原有的“去买单”、“刷门禁”配置; 配置card_action_list参数,生成新的“去买单”、“刷门禁”按钮;