开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
网页&移动应用 
开发 > 服务端 > 营销产品 > api 列表 > 商家券活动 > 修改商家券活动发券数量上限接口
文档更新记录 >
收藏
订阅更新
我的文档
设置
商家调用该接口修改商家券活动预算上限,以此来追加商家券活动预算。
修改商家券活动预算上限同步返回追加请求受理结果,后续通过alipay.marketing.activity.message.appended消息接口异步发送发券数量上限修改成功事件消息。
code_mode=merchant_upload场景下,必须先导入券码后,方可追加商家券预算。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.marketing.activity.ordervoucher.append
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

activity_id|活动 id必选string[1,128]
【描述】活动id
【示例值】2016042700826004508401111111
voucher_quantity|发行券的数量必选number[1,99999999]
【描述】券总预算值。
限制:
券总预算<= 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"
}' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

无业务响应参数
响应示例
{
    "alipay_marketing_activity_ordervoucher_append_response": {
        "code": "10000",
        "msg": "success"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。

公共错误码

业务错误码

错误码错误描述凯发app官方网站的解决方案
system_error服务器异常
可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试
invalid_parameter参数有误参数非法
请根据接口返回的参数非法的具体错误信息,修改参数后进行重试。
biz_error业务异常业务异常活动存在正在进行中的其他操作
活动的创建、修改、追加等操作都是异步进行的。因此如在活动修改中时,发出追加操作,会提示活动存在正在进行中的其他操作。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图