通用场景
会员卡模板外部权益查询
公共请求参数
业务请求参数
template_id｜会员卡模板id必选string[1,32]
【描述】会员卡模板id，通过 （会员卡模板创建)接口创建会员卡模板获取。
【示例值】20170322000000000068101000300041
benefit_id｜权益id可选string[1,32]
【描述】权益id，通过 (会员卡模板外部权益创建)接口创建获取。
【示例值】20170322000000000068101000300041
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.card.benefit.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"benefit_id":"20170322000000000068101000300041",
"template_id":"20170322000000000068101000300041"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
mcard_template_benefit_query｜会员卡模板外部权益列表必选mcardtemplatebenefitquery[]
【描述】会员卡模板外部权益列表
benefit_id｜权益id必选string(32)
【描述】权益id
【示例值】20170322000000000068101000300041
template_id｜会员卡模板id必选string(32)
【描述】会员卡模板id
【示例值】20170322000000000068101000300041
title｜权益标题必选string(16)
【描述】权益标题
【示例值】使用会员卡消费享8折优惠
benefit_desc｜权益描述信息必选string(1024)
【描述】权益描述信息
【示例值】使用会员卡享8折优惠
start_date｜权益开始时间必选date(64)
【描述】权益开始时间
【示例值】2017-04-18 15:10:23
end_date｜权益结束时间必选date(64)
【描述】权益结束时间
【示例值】2017-04-18 15:10:23
ext_info｜会员卡模板权益扩展信息必选string(4000)
【描述】会员卡模板权益扩展信息：json格式; openurl 说明：跳转到商户的优惠活动页面
【示例值】{"openurl":"http://www.koubei.com"}
响应示例
正常示例
异常示例
{
"alipay_marketing_card_benefit_query_response": {
"code": "10000",
"msg": "success",
"mcard_template_benefit_query": [
{
"benefit_id": "20170322000000000068101000300041",
"template_id": "20170322000000000068101000300041",
"title": "使用会员卡消费享8折优惠",
"benefit_desc": "使用会员卡享8折优惠",
"start_date": "2017-04-18 15:10:23",
"end_date": "2017-04-18 15:10:23",
"ext_info": "{\"openurl\":\"http://www.koubei.com\"}"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| benefit_not_exist | 权益不存在 | 查看message定位问题 |
| template_not_exist | 卡模板不存在 | 查看message定位问题 |