對接文檔校園卡更新樣式 新版本樣式隻在用戶端版本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.modify;
同樣:調用前請在先在測試卡模闆上驗證。 傳參card_action_list <
> 字段:
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參數,生成新的“去買單”、“刷門禁”按鈕;