开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
邀测站点 

辅助功能 -凯发app官方网站

收藏
我的文档
设置
除了基本发卡链路外,开放平台还为开发者和商户提供了后续的配套接口,用于会员卡模板的查询和修改,以及会员卡的查询,更新和删除。
会员卡查询接口
商家/服务商可通过 alipay.marketing.card.query(会员卡查询接口)根据卡号或者持卡人信息查询会员卡信息。
请求示例
java
复制代码
/**
* 会员卡查询
* @param appauthtoken如isv代替商户调用接口,需将商户授权后获取的app_auth_token带上;如商户自己调用,则传null。
* @param bizcontent 因该接口业务参数复杂,请详见接口文档
* @return
* @throws alipayapiexception 请处理异常
*/
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do", app_id, app_private_key, "json", charset, alipay_public_key, "rsa2");
alipaymarketingcardqueryrequest request = new alipaymarketingcardqueryrequest();
// request.putothertextparam("app_auth_token", appauthtoken);
request.setbizcontent(bizcontent);
alipaymarketingcardqueryresponse response = alipayclient.execute(request);
system.out.println(response.getbody());
bizcontent 示例
json
复制代码
"{"
"\"target_card_no\":\"prex0000001781\","
"\"target_card_no_type\":\"biz_card\","
"\"card_user_info\":{"
"\"user_uni_id\":\"20884025********\","
"\"user_uni_id_type\":\"uid\""
"}}"
说明:
target_card_no:会员卡业务号,在调用开卡接口成功后支付宝返回的 biz_card_no 参数的值。
user_uni_id:支付宝用户号 userid,为 2088 开头的 16 位数字。
更多入参及响应示例详情可查看 alipay.marketing.card.query(会员卡查询接口)文档。
会员卡更新接口
商户/服务商可调用 alipay.marketing.card.update(会员卡更新接口),更新指定会员卡信息。
注意:
更新会员卡后,只有该张会员卡会进行更新,其它会员卡不会更新。可借此实现不同会员等级会员卡展示不同样式,详情可查看 按会员等级展示不同卡片内容
open_date(开卡时间)和 valid_date(结束时间)不支持修改,设置后无效。
不支持设置 notify_messages(卡信息变更通知消息),设置后无效,不会发送通知。
其它修改项因为线上缓存的缘故,模板更新可能存在 1 ~ 5 分钟延时。
请求示例
bizcontent 示例
说明:
target_card_no 为会员卡业务号,在调用开卡接口成功后支付宝返回的 biz_card_no 参数的值。
更多入参及响应示例详情可查看 alipay.marketing.card.update(会员卡更新接口)文档。
会员卡删除接口
商户/服务商可调用 alipay.marketing.card.delete(会员卡删卡接口)删除指定会员卡。
请求示例
bizcotent 示例
说明:
out_serial_no 为请求唯一标识,每次请求需保证唯一。
target_card_no 为会员卡业务号,调用开卡接口成功后支付宝返回的 biz_card_no 参数的值。
更多入参及响应示例详情可查看 alipay.marketing.card.delete(会员卡删卡接口)文档。
会员卡模板修改接口
商户/服务商可调用 alipay.marketing.card.template.modify(会员卡模板修改接口),修改该模板样式等信息。
注意:
修改会员卡模板后,该模板下所有会员卡都会更新(包括已发放会员卡)。
修改会员卡模板,field_rule_list(字段规则列表)配置项不支持修改,设置后无效。
其它修改项因为线上缓存的缘故,模板更新可能存在 1 ~ 5 分钟延时。
请求示例
bizcontent 示例
说明:
request_id 为请求唯一标识,每次请求请保证唯一性。
logo_id 和 background_id 通过 alipay.offline.material.image.upload(支付宝图片资料上传接口)获取。
更多入参及响应示例详情可查看 alipay.marketing.card.template.modify(会员卡模板修改接口)文档。
会员卡模板查询接口
商户/服务商可调用 alipay.marketing.card.template.query(会员卡模板查询接口)查询指定模板详情。
sdk 调用示例
说明:template_id :模板 id,通过会员卡模板创建接口获取。
更多入参及响应示例详情可查看 alipay.marketing.card.template.query(会员卡模板查询接口)文档。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图