更新时间:2023-09-11 10:19:25收藏我的文档设置返回文档场景说明发布卡券给用户时,必须要先创建卡券模板,但是目前 alipay.pass.template.add(卡券模板创建接口)参数数据过多,传递参数时常会因为格式或者某些参数少传出现一系列报错,从而导致集成耗费时间。注意:以下介绍的方法只获取模板创建接口中的 tpl_content 参数内的 content 数据值。 获取创建模板参数说明通过平台创建样式后获取模板参数1通过访问 alipay.pass.template.add(卡券模板创建接口),对显示的内容数据进行编写,如下图所示。 2根据要求进行编写成功后,点击提交按钮,提交时可选择在支付宝客户端内进行预览编写好的样式。3通过点击 ,找到前一步创建成功的劵模板,按照以下截图方式去操作下载该模板样式。 4下载成功后会获取(****.alipass)文件,将其解压,然后获取 pass.json 文件全部内容,再对里面是数据内容进行修改。 说明:获取的 pass.json 数据内容是一行格式的,可尝试使用 进行转换,从而达到快速更换数据内容。pass.json 说明pass.json 文件的内需修改的内容●修改 platform > channelid 字段值,改为发券的 appid。●删除 platform > webserviceurl 字段,历史遗留参数,直接删掉节点即可。●修改 fileinfo > serialnumber 字段值,值改为 $serialnumber$(动态参数); serialnumber 指定券模板下发给每个用户的券 id,必须配置成动态参数,因为每张券的券 id 应保持唯一性,而每次调用发券接口中都需要指定 serialnumber 参数的值。●添加 merchant 节点○添加 merchant.mname 字段,配置商家展示名称。(如果有不需要修改)。○添加 merchant.mcallbackurl 字段,配置接收 token 表单的商家页面回调地址。要求必须可以外网访问,以 https 开头的 url。修改后的 pass.json 数据样列内容修改成功后内容数据对应的就是 alipay.pass.template.add(卡券模板创建接口)中 tpl_content 参数内的 content 数据内容,传递示例如下:通过平台上已有的样式进行获取模板参数1通过访问 ,点击需要的劵模板,选择下载按钮,如下图。 2下载成功后会获取(****.alipass)文件,将其解压,然后获取 pass.json 文件全部内容,再对里面是数据内容进行修改。 说明:获取的 pass.json 数据内容是一行格式的,可尝试使用 进行转换,从而达到快速更换数据内容。pass.json 说明pass.json 文件的内需修改的内容●修改 platform > channelid 字段值,改为发券的 appid。●删除 platform > webserviceurl 字段,历史遗留参数,直接删掉节点即可。●修改 fileinfo > serialnumber 字段值,值改为 $serialnumber$(动态参数); serialnumber 指定券模板下发给每个用户的券 id,必须配置成动态参数 ,因为每张券的券 id 应保持唯一性,而每次调用发券接口中都需要指定 serialnumber 参数的值。●添加 merchant 节点:○添加 merchant.mname 字段,配置商家展示名称(如果有不需要修改)。○添加 merchant.mcallbackurl 字段,配置接收 token 表单的商家页面回调地址。要求必须可以外网访问,以 https 开头的 url。修改后的 pass.json 数据样列内容修改成功后内容数据对应的就是 alipay.pass.template.add(卡券模板创建接口)中 tpl_content 参数内的 content 数据内容,传递示例如下所示。