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