#支付宝 如何快速获取支付宝卡券创建模板参数？

一、场景说明

发布卡券给用户时，必须要先创建卡券模板，但是目前【卡券模板创建接口】参数数据过多，传递参数时常会因为格式或者某些参数少传出现一系列报错，从而导致集成耗费时间。

注：以下介绍的方法只获取模板创建接口中的tpl_content 参数内的 content数据值。

二、获取创建模板参数说明

1、通过平台创建样式后获取模板参数

1、通过访问【卡券模板创建平台】，对显示的内容数据进行编写，如下图。

2、根据要求进行编写成功后，点击提交按钮，提交时可选择在手机钱包app内进行预览编写好的样式。

3、通过点击【我的alipass】，找到前一步创建成功的劵模板，按照以下截图方式去操作下载该模板样式。

4、下载成功后会获取（****.alipass）文件，将其解压，然后获取pass.json文件全部内容，再对里面是数据内容进行修改。

注：获取的pass.json数据内容是一行格式的，可尝试使用【json格式化工具】进行转换，从而达到快速更换数据内容。

5、pass.json文件的内需修改的内容如下：

（1）修改 platform > channelID 字段值，改为发券的 appId。

（2）删除 platform > webServiceUrl 字段，历史遗留参数，直接删掉节点即可。

（3）修改 fileInfo > serialNumber 字段值，值改为 $serialNumber$（动态参数）； serialNumber指定券模板下发给每个用户的券Id，必须配置成动态参数，因为每张券的券 id 应保持唯一性，而每次调用发券接口中都需要指定 serialNumber 参数的值。

（4）添加 merchant 节点：

a、添加 merchant.mname 字段，配置商家展示名称。（如果有不需要修改）。

b、添加 merchant.mcallbackUrl 字段，配置接收 token 表单的商家页面回调地址。要求必须可以外网访问，以https开头的url。

修改后的pass.json数据样列内容如下：

{ "evoucherInfo":{ "title":"上优酷，看世界杯优酷VIP会员3天", "type":"marketVoucher", "product":"free", "startDate":"$activeTime$", "endDate":"$expireTime$", "operation":[ { "format":"url", "message":"$url$", "altText":"立即激活" } ], "einfo":{ "logoText":"3天", "secondLogoText":"64场高清直播，进球就下红包雨", "auxiliaryFields":[

        ],
        "customFields":[
            {
                "label":"详细说明",
                "value":"",
                "type":"url",
                "more":{
                    "url":"http://xxxxxxxxxxxx"
                }
            }
        ],
        "useLimitDesc":"优酷VIP会员",
        "brandName":"上优酷，看世界杯",
        "originPrice":"",
        "banner":{
            "bannerImg":"",
            "url":""
        },
        "passImg":"https://tfsimg.alipay.com/images/alipassprod/TB17fLOXB8rDuNk6Xejwu2EYXXa",
        "passImgRatio":"2.79"
    }
},
"platform":{
    "channelID":"2018041602567779"
},
"style":{
    "backgroundColor":"RGB(233,16,78)"
},
"fileInfo":{
    "formatVersion":"4",
    "canShare":true,
    "canBuy":false,
    "canPresent":false,
    "serialNumber":"$serialNumber$"
},
"source":"alipassprod",
"merchant":{
    "mname":"优酷视频",
    "mcallbackUrl":"https://test.callback.com/alipay/callback.htm"
}

}

注：修改成功后内容数据对应的就是【alipay.pass.template.add(卡券模板创建接口)】中tpl_content 参数内的 content数据内容，传递示例如下 ：

"tpl_content": { "logo": "https://tfsimg.alipay.com/images/alipassprod/TB1FrtIXNem.eJkUQtAwu1lJXXa", "content":{"evoucherInfo":{"title":"上优酷，看世界杯优酷VIP会员3天","type":"marketVoucher","product":"free","startDate":"$activeTime$","endDate":"$expireTime$","operation":[{"format":"url","message":"$url$","altText":"立即激活"}],"einfo":{"logoText":"3天","secondLogoText":"64场高清直播，进球就下红包雨","auxiliaryFields":[],"customFields":[{"label":"详细说明","value":"","type":"url","more":{"url":"http://xxxxxxxxxxxx"}}],"useLimitDesc":"优酷VIP会员","brandName":"上优酷，看世界杯","originPrice":"","banner":{"bannerImg":"","url":""},"passImg":"https://tfsimg.alipay.com/images/alipassprod/TB17fLOXB8rDuNk6Xejwu2EYXXa","passImgRatio":"2.79"}},"platform":{"channelID":"2018041602567779","webServiceUrl":""},"style":{"backgroundColor":"RGB(233,16,78)"},"fileInfo":{"formatVersion":"4","canShare":true,"canBuy":false,"canPresent":false,"serialNumber":"$serialNumber$"},"source":"alipassprod","merchant":{"mname":"优酷视频","mcallbackUrl":"https://100.88.23.63:4443"}} }

2、通过平台上已有的样式进行获取模板参数

1、通过访问【卡券平台】，点击需要的劵模板，选择下载按钮，如下图。

2、下载成功后会获取（****.alipass）文件，将其解压，然后获取pass.json文件全部内容，再对里面是数据内容进行修改。

注：获取的pass.json数据内容是一行格式的，可尝试使用【json格式化工具】进行转换，从而达到快速更换数据内容。

3、pass.json文件的内需修改的内容如下：

（1）修改 platform > channelID 字段值，改为发券的 appId。

（2）删除 platform > webServiceUrl 字段，历史遗留参数，直接删掉节点即可。

（3）修改 fileInfo > serialNumber 字段值，值改为 $serialNumber$（动态参数）； serialNumber指定券模板下发给每个用户的券Id，必须配置成动态参数 ，因为每张券的券 id 应保持唯一性，而每次调用发券接口中都需要指定 serialNumber 参数的值。

（4）添加 merchant 节点：

a、添加 merchant.mname 字段，配置商家展示名称（如果有不需要修改）。

b、添加 merchant.mcallbackUrl 字段，配置接收 token 表单的商家页面回调地址。要求必须可以外网访问，以https开头的url。

修改后的pass.json数据样列内容如下：

{ "evoucherInfo":{ "title":"上优酷，看世界杯优酷VIP会员3天", "type":"marketVoucher", "product":"free", "startDate":"$activeTime$", "endDate":"$expireTime$", "operation":[ { "format":"url", "message":"$url$", "altText":"立即激活" } ], "einfo":{ "logoText":"3天", "secondLogoText":"64场高清直播，进球就下红包雨", "auxiliaryFields":[

        ],
        "customFields":[
            {
                "label":"详细说明",
                "value":"",
                "type":"url",
                "more":{
                    "url":"http://xxxxxxxxxxxx"
                }
            }
        ],
        "useLimitDesc":"优酷VIP会员",
        "brandName":"上优酷，看世界杯",
        "originPrice":"",
        "banner":{
            "bannerImg":"",
            "url":""
        },
        "passImg":"https://tfsimg.alipay.com/images/alipassprod/TB17fLOXB8rDuNk6Xejwu2EYXXa",
        "passImgRatio":"2.79"
    }
},
"platform":{
    "channelID":"2018041602567779"
},
"style":{
    "backgroundColor":"RGB(233,16,78)"
},
"fileInfo":{
    "formatVersion":"4",
    "canShare":true,
    "canBuy":false,
    "canPresent":false,
    "serialNumber":"$serialNumber$"
},
"source":"alipassprod",
"merchant":{
    "mname":"优酷视频",
    "mcallbackUrl":"https://test.callback.com/alipay/callback.htm"
}

}

注：修改成功后内容数据对应的就是【alipay.pass.template.add(卡券模板创建接口)】中tpl_content 参数内的 content数据内容，传递示例如下 ：

"tpl_content": { "logo": "https://tfsimg.alipay.com/images/alipassprod/TB1FrtIXNem.eJkUQtAwu1lJXXa", "content":{"evoucherInfo":{"title":"上优酷，看世界杯优酷VIP会员3天","type":"marketVoucher","product":"free","startDate":"$activeTime$","endDate":"$expireTime$","operation":[{"format":"url","message":"$url$","altText":"立即激活"}],"einfo":{"logoText":"3天","secondLogoText":"64场高清直播，进球就下红包雨","auxiliaryFields":[],"customFields":[{"label":"详细说明","value":"","type":"url","more":{"url":"http://xxxxxxxxxxxx"}}],"useLimitDesc":"优酷VIP会员","brandName":"上优酷，看世界杯","originPrice":"","banner":{"bannerImg":"","url":""},"passImg":"https://tfsimg.alipay.com/images/alipassprod/TB17fLOXB8rDuNk6Xejwu2EYXXa","passImgRatio":"2.79"}},"platform":{"channelID":"2018041602567779","webServiceUrl":""},"style":{"backgroundColor":"RGB(233,16,78)"},"fileInfo":{"formatVersion":"4","canShare":true,"canBuy":false,"canPresent":false,"serialNumber":"$serialNumber$"},"source":"alipassprod","merchant":{"mname":"优酷视频","mcallbackUrl":"https://100.88.23.63:4443"}} }