通用场景
对于已经创建的模板,如果需要修改模板内容,可通过该接口修改,适用于修改模板内容;对于已经发布的模板,如果需要修改内容并同步到用户端,则应使用更新卡券接口。
公共请求参数
业务请求参数
tpl_id可选string(999)
【描述】支付宝pass模版id。通过alipay.pass.template.add(卡券模板创建接口)创建模板后返回的tpl_id。
【示例值】f038871a4b1151e8038bb9277c3d52e3
tpl_content可选string(99999)
【描述】模板内容信息,遵循json规范,详情参见tpl_content 参数详细说明。
【示例值】{"logo": "","strip": null,"icon": null,"content": {}}
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipaypasstemplateupdaterequest request = new alipaypasstemplateupdaterequest();
request.setbizcontent("{"
" \"tpl_id\":\"f038871a4b1151e8038bb9277c3d52e3\","
" \"tpl_content\":\"{\\\"logo\\\": \\\"\\\",\\\"strip\\\": null,\\\"icon\\\": null,\\\"content\\\": {}}\""
"}");
alipaypasstemplateupdateresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}
说明:本示例仅供参考。
公共响应参数
业务响应参数
success必选string
【描述】操作成功标识【true:成功;false:失败】
【示例值】true
result必选string(5000)
【描述】接口调用返回结果信息(json字串):
errorcode:处理结果码(错误码);
errormsg:处理结果说明(错误说明);
tpl_id:模板编号,预期在调发券接口时必须传入;
tpl_params:动态参数(变量)列表,预期在调发券接口时传入;
errorcode:处理结果码(错误码);
errormsg:处理结果说明(错误说明);
tpl_id:模板编号,预期在调发券接口时必须传入;
tpl_params:动态参数(变量)列表,预期在调发券接口时传入;
【示例值】{"errorcode":"kp.ae_success","errormsg":"处理成功","tpl_id":"2017032xxxxxxxx","tpl_params":["title","channelid","serialnumer"]}
响应示例
正常示例
异常示例
{
"alipay_pass_template_update_response": {
"code": "10000",
"msg": "success",
"success": "true",
"result": "{\"errorcode\":\"kp.ae_success\",\"errormsg\":\"处理成功\",\"tpl_id\":\"2017032xxxxxxxx\",\"tpl_params\":[\"title\",\"channelid\",\"serialnumer\"]}"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
kp.ae_system_error | 系统繁忙或系统异常 | 尝试重试 |
kp.ae_alipass_template_paramter_is_null | 模板参数为空 | 确认请求中的模板参数是否为空 |
kp.ae_alipass_template_app_id_is_null | 入参app_id为空 | 确认参数app_id是否填入 |
kp.ae_alipass_template_content_is_blank | 入参tpl_content为空 | 确认参数tpl_content是否填入 |
kp.ae_alipass_template_unique_id_is_blank | 入参unique_id为空 | 确认参数unique_id是否填入 |
kp.ae_alipass_recognition_type_nosupport | 发券方式不支持 | 确认appid已填入的前提下,尝试重试 |
kp.ae_alipass_template_content_format_err | 入参tpl_content格式错误 | 确认参数tpl_content格式是否正确 |
kp.ae_alipass_template_not_exist | 目标模板信息不存在 | 确认tpl_id传入值为预期的模板编号 |
kp.ae_illegal_parameters | 保存模板信息时存在参数错误 | 确认参数是否符合文档预期,尝试重试 |
kp.ae_alipass_data_contain_forbidden_word | 模板内容中存在敏感词、违禁词 | 去除模板内容中的敏感词、违禁词 |
kp.ae_alipass_template_unrecognize_property | 模板内容tpl_content中存在不识别的属性 | 核查确认入参tpl_content中的字段属性符合文档预期 |