修改商家券活动发券数量上限

开发环境

http://dev-cn.your-api-server.com

PATCH

/v3/alipay/marketing/ordervoucher/activity/{activity_id}/append

alipay.marketing.activity.ordervoucher

商家调用该接口修改商家券活动预算上限，以此来追加商家券活动预算。
修改商家券活动预算上限同步返回追加请求受理结果，后续通过alipay.marketing.activity.message.appended消息接口异步发送发券数量上限修改成功事件消息。
code_mode=MERCHANT_UPLOAD场景下，必须先导入券码后，方可追加商家券预算。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'http://dev-cn.your-api-server.com/v3/alipay/marketing/ordervoucher/activity//append' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchant_access_mode": "AGENCY_MODE",
    "out_biz_no": "20170101000001654bb46ba",
    "voucher_quantity": 100
}'

响应示例

200 - 示例 1

{}

请求参数

Path 参数

activity_id

string

活动id

必需

Body 参数application/json

merchant_access_mode

string

商户接入模式

可选

示例值:

AGENCY_MODE

out_biz_no

string

可选

外部业务单号，用作幂等控制。幂等作用：参数不变的情况下，再次请求返回与上一次相同的结果。外部接入方需保证业务单号唯一。

示例值:

20170101000001654bb46ba

voucher_quantity

integer

可选

发行券的数量。限制：券总预算<= 999999 特别说明：该字段的含义是追加到的数量。不可减少，只能增加。 code_mode= MERCHANT_UPLOAD 的情况下，voucher_quantity 需要与导入码的总数量保持一致（即历史导入数量 + 追加导入数量）。

示例值:

100

示例

返回响应

🟢200common response

application/json

Body

object {0}

🔴500请求失败

券活动预算追加通知

领券组件插件接入流程