卡券模板创建接口 -凯发app官方网站

支持第三方代理调用

更新时间：2023-05-04 17:38:00

努力加载中...

通用场景

创建卡券的模板，卡券的样式、内容信息通过该接口提交到支付宝，支付宝会生成模板id反馈给开发者，用于后续的更新和发布。

1 公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.pass.template.add
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

2 请求参数

参数	类型	是否必选	最大长度	描述	示例值
unique_id	string	必选	999	商户用于控制模版的唯一性。（可以使用时间戳保证唯一性）	20140709150010
tpl_content	string	必选	99999	模板内容信息，遵循json规范，详情参见tpl_content 参数详细说明。	{"logo": "","strip": null,"icon": null,"content": {}}

3 公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

4 响应参数

参数	类型	是否必选	最大长度	描述	示例值
success	string	必选	99	操作成功标识【true：成功；false：失败】	true
result	string	必选	9999	接口调用返回结果信息(json字串): errorcode：处理结果码（错误码）； errormsg：处理结果说明（错误说明）； tpl_id：模板编号，预期在调发券接口时必须传入； tpl_params：动态参数（变量）列表，预期在调发券接口时传入；	{"errorcode":"kp.ae_success","errormsg":"处理成功","tpl_id":"2017032xxxxxxxx","tpl_params":["title","channelid","serialnumber"]}

5 请求示例

java

php

http

alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipaypasstemplateaddrequest request = new alipaypasstemplateaddrequest();
request.setbizcontent("{" 
"  \"unique_id\":\"20140709150010\"," 
"  \"tpl_content\":\"{\\\"logo\\\": \\\"\\\",\\\"strip\\\": null,\\\"icon\\\": null,\\\"content\\\": {}}\"" 
"}");
alipaypasstemplateaddresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}

6 响应示例

json

xml

{
    "alipay_pass_template_add_response": {
        "code": "10000",
        "msg": "success",
        "success": "true",
        "result": "{\"errorcode\":\"kp.ae_success\",\"errormsg\":\"处理成功\",\"tpl_id\":\"2017032xxxxxxxx\",\"tpl_params\":[\"title\",\"channelid\",\"serialnumber\"]}"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

7 异常示例

json

{
    "alipay_pass_template_add_response": {
        "code": "20000",
        "msg": "service currently unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

8 错误码

8.1 公共错误码

8.2 业务错误码

错误码	错误描述	凯发app官方网站的解决方案
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_alipss_template_existed	模版已存在	模板已存在，如需更新模板内容请调用alipay.pass.template.update接口；如的确需要重新创建模板，需要变更请求参数中的unique_id
kp.ae_system_error	系统繁忙或系统异常	尝试重试
kp.ae_illegal_parameters	保存模板信息时存在参数格式错误	确认参数格式是否符合文档需求，如有效期时间字段格式等
kp.ae_alipass_data_contain_forbidden_word	模板内容中存在敏感词、违禁词	去除模板内容中的敏感词、违禁词
kp.ae_alipass_template_unrecognize_property	模板内容中存在不识别的属性	核查确认tpl_content中的字段属性符合文档预期

1 公共请求参数

2 请求参数

3 公共响应参数

4 响应参数

5 请求示例

6 响应示例

7 异常示例

8 错误码

8.1 公共错误码

8.2 业务错误码

相关问题