卡券模板创建接口

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

错误码

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	KP.AE_ALIPASS_TEMPLATE_PARAMTER_IS_NULL	模板参数为空	确认请求中的模板参数是否为空
400	KP.AE_ALIPASS_TEMPLATE_APP_ID_IS_NULL	入参app_id为空	确认参数app_id是否填入
400	KP.AE_ALIPASS_TEMPLATE_CONTENT_IS_BLANK	入参tpl_content为空	确认参数tpl_content是否填入
400	KP.AE_ALIPASS_TEMPLATE_UNIQUE_ID_IS_BLANK	入参unique_id为空	确认参数unique_id是否填入
400	KP.AE_ALIPASS_RECOGNITION_TYPE_NOSUPPORT	发券方式不支持	确认appId已填入的前提下，尝试重试
400	KP.AE_ALIPSS_TEMPLATE_EXISTED	模版已存在	模板已存在，如需更新模板内容请调用alipay.pass.template.update接口；如的确需要重新创建模板，需要变更请求参数中的unique_id
400	KP.AE_SYSTEM_ERROR	系统繁忙或系统异常	尝试重试
400	KP.AE_ILLEGAL_PARAMETERS	保存模板信息时存在参数格式错误	确认参数格式是否符合文档需求，如有效期时间字段格式等
400	KP.AE_ALIPASS_DATA_CONTAIN_FORBIDDEN_WORD	模板内容中存在敏感词、违禁词	去除模板内容中的敏感词、违禁词
400	KP.AE_ALIPASS_TEMPLATE_UNRECOGNIZE_PROPERTY	模板内容中存在不识别的属性	核查确认tpl_content中的字段属性符合文档预期

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/pass/template/add' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "unique_id":"20140709150010", "tpl_content":"{\"logo\": \"\",\"strip\": null,\"icon\": null,\"content\": {}}" }'

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

unique_id

string

必需

商户用于控制模版的唯一性。（可以使用时间戳保证唯一性）

tpl_content

string

必需

模板内容信息，遵循JSON规范，详情参见tpl_content 参数详细说明。

示例

返回响应

🟢200成功

application/json

Body

success

string

必需

操作成功标识【true：成功；false：失败】

result

string

必需

接口调用返回结果信息(json字串): errorCode：处理结果码（错误码）； errorMsg：处理结果说明（错误说明）； tpl_id：模板编号，预期在调发券接口时必须传入； tpl_params：动态参数（变量）列表，预期在调发券接口时传入；

卡券模板创建接口

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码