商家券历史版
商家调用该接口修改商家券活动预算上限,以此来追加商家券活动预算。
修改商家券活动预算上限同步返回追加请求受理结果,后续通过alipay.marketing.activity.message.appended消息接口异步发送发券数量上限修改成功事件消息。
code_mode=merchant_upload场景下,必须先导入券码后,方可追加商家券预算。
修改商家券活动预算上限同步返回追加请求受理结果,后续通过alipay.marketing.activity.message.appended消息接口异步发送发券数量上限修改成功事件消息。
code_mode=merchant_upload场景下,必须先导入券码后,方可追加商家券预算。
修改商家券活动发券数量上线接口返回结果并不代表活动修改成功,必须等待消息回调后才能确保成功。
如果成功消息长时间未送达,请联系相关凯发app官方网站的技术支持协助排查。
如果成功消息长时间未送达,请联系相关凯发app官方网站的技术支持协助排查。
公共请求参数
业务请求参数
activity_id|活动 id必选string[1,128]
【描述】活动id
【示例值】2016042700826004508401111111
voucher_quantity|发行券的数量必选number[1,99999999]
【描述】券总预算值。
限制:
券总预算<= 999999
特别说明:
该字段的含义是追加到的数量。
不可减少,只能增加。
code_mode=
merchant_upload 的情况下,voucher_quantity 需要与导入码的总数量保持一致(即历史导入数量 追加导入数量)。
限制:
券总预算<= 999999
特别说明:
该字段的含义是追加到的数量。
不可减少,只能增加。
code_mode=
merchant_upload 的情况下,voucher_quantity 需要与导入码的总数量保持一致(即历史导入数量 追加导入数量)。
【示例值】15
out_biz_no|外部业务单号必选string[1,64]
【描述】外部业务单号,用作幂等控制。
幂等作用:
参数不变的情况下,再次请求返回与上一次相同的结果。
外部接入方需保证业务单号唯一。
幂等作用:
参数不变的情况下,再次请求返回与上一次相同的结果。
外部接入方需保证业务单号唯一。
【示例值】20170101000001654bb46ba
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.activity.ordervoucher.append&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"voucher_quantity":15,
"activity_id":"2016042700826004508401111111",
"out_biz_no":"20170101000001654bb46ba"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_marketing_activity_ordervoucher_append_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 服务器异常 | 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误参数非法 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试。 |
biz_error | 业务异常业务异常活动存在正在进行中的其他操作 | 活动的创建、修改、追加等操作都是异步进行的。因此如在活动修改中时,发出追加操作,会提示活动存在正在进行中的其他操作。 |