通用场景
卡券模板生成后，如需将卡券发布给对应的用户，则调用此接口。
公共请求参数
业务请求参数
tpl_id必选string(999)
【描述】 支付宝pass模版id。通过alipay.pass.template.add(卡券模板创建接口)创建模板后返回的tpl_id。
【示例值】f038871a4b1151e8038bb9277c3d52e3
tpl_params必选string(99999)
【描述】模版动态参数信息，对应模板中$变量名$的动态参数。对应alipay.pass.template.add(卡券模板创建接口)创建模板后返回tpl_params字段。
【示例值】{"title":"券标题","channelid":"xxx","serialnumber":"xxxx"}
recognition_type必选string(999)
【描述】alipass添加对象识别类型，枚举如下：
1：订单信息；
2：基于用户信息识别。
说明：支付宝卡包场景暂仅支持 2。
1：订单信息；
2：基于用户信息识别。
说明：支付宝卡包场景暂仅支持 2。
【示例值】2
recognition_info必选string(999)
【描述】支付宝用户识别信息，详见 调用接口发券。
【示例值】{"recognition_info":{"user_id":"2088402021319452"}}
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipaypassinstanceaddrequest request = new alipaypassinstanceaddrequest();
request.setbizcontent("{"
" \"tpl_id\":\"f038871a4b1151e8038bb9277c3d52e3\","
" \"tpl_params\":\"{\\\"title\\\":\\\"券标题\\\",\\\"channelid\\\":\\\"xxx\\\",\\\"serialnumber\\\":\\\"xxxx\\\"}\","
" \"recognition_type\":\"2\","
" \"recognition_info\":\"{\\\"recognition_info\\\":{\\\"user_id\\\":\\\"2088402021319452\\\"}}\""
"}");
alipaypassinstanceaddresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}说明：本示例仅供参考。
公共响应参数
业务响应参数
success必选string(99)
【描述】操作成功标识【true：成功；false：失败】
【示例值】true
result必选string(9999)
【描述】接口调用返回结果信息
serialnumber：唯一核销凭证串号（必须由动态传参指定）
passid：券唯一id
operation：本次调用的操作类型，add
errorcode：处理结果码（错误码）
errormsg：处理结果说明（错误说明）
serialnumber：唯一核销凭证串号（必须由动态传参指定）
passid：券唯一id
operation：本次调用的操作类型，add
errorcode：处理结果码（错误码）
errormsg：处理结果说明（错误说明）
【示例值】{"serialnumber":"123555123","passid":"209919213","operate":"add","errorcode":"success","errormsg":"处理成功"}
响应示例
正常示例
异常示例
{
"alipay_pass_instance_add_response": {
"code": "10000",
"msg": "success",
"success": "true",
"result": "{\"serialnumber\":\"123555123\",\"passid\":\"209919213\",\"operate\":\"add\",\"errorcode\":\"success\",\"errormsg\":\"处理成功\"}"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| kp.ae_alipass_parame_is_null | 参数值为null | 根据返回值result的errormsg检查发券参数tpl_params是否缺失动态参数对应的值 |
| kp.ae_alipass_recognition_type_nosupport | alipass添加对象识别类型不识别 | 检查recongnition_type值是否为1，必要时请至支持中心（https://support.open.alipay.com/alipay/support/index.htm）提问，或点击右上角帮助支持→在线咨询，联系凯发k8官方网娱乐官方的技术客服来解决 |
| kp.ae_system_error | 系统异常 | 尝试重试，必要时请至支持中心（https://support.open.alipay.com/alipay/support/index.htm）提问，或点击右上角帮助支持→在线咨询，联系凯发k8官方网娱乐官方的技术客服来解决 |
| kp.ae_alipass_appid_nosupport | 该appid在黑名单中，因而不支持发券 | 请至支持中心（https://support.open.alipay.com/alipay/support/index.htm）提问，或点击右上角帮助支持→在线咨询，联系凯发k8官方网娱乐官方的技术客服来解决 |
| kp.ae_alipass_userid_nosupport | 发券的目标用户在黑名单中，不支持发券 | 请至支持中心（https://support.open.alipay.com/alipay/support/index.htm）提问，或点击右上角帮助支持→在线咨询，联系凯发k8官方网娱乐官方的技术客服来解决 |
| kp.ae_alipass_params_value_invaild | 无效的参数传值 | 核查tpl_params中的参数格式是否正确，例如时间参数等。 |
| kp.ae_alipass_params_format_error | 参数格式不正确或调用参数biz_content整体非json格式 | 确认参数格式符合预期，确认传参biz_content符合json规范 |
| kp.ae_alipass_char_not_gbk | 卡券传值中有非gbk的字符 | 确认传参字符为gbk编码 |
| kp.ae_alipass_token_valid_fail | token令牌信息校验失败 | 确认user_token参数传入的是否是实时获取的token令牌 |