天天看點

電子校園卡式樣模闆建立指南

對接文檔校園卡更新樣式 新版本樣式隻在用戶端版本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參數,生成新的“去買單”、“刷門禁”按鈕;