支付宝

商户修改商品代金券

开发环境

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

POST

/v3/koubei/marketing/campaign/item/merchantactivity/modify

koubei.marketing.campaign.item.merchantactivity

商户修改商品代金券

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/koubei/marketing/campaign/item/merchantactivity/modify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "voucher_info": {
        "logo": "券logo",
        "user_introductions": "使用须知",
        "valid_days_range_to": 12,
        "valid_time_type": "RELATIVE",
        "valid_time_range_to": {}
    },
    "activity_id": "2018xxxx",
    "external_callback_url": "xxxx",
    "memo": "备注",
    "gmt_end": {},
    "item_ids": "[\"2018xxxx\",\"2018xxxx\"]"
}'

响应示例

200 - 示例 1

{}

请求参数

Body 参数application/json

voucher_info

object (MerchantActivityModifyVoucherInfo)

可选

logo

string

可选

券logo 券logo最大字符数不能超过64

示例值:

券logo

user_introductions

string

可选

使用须知券使用须知最大字符数不能超过256

示例值:

使用须知

valid_days_range_to

integer

可选

领取后, 第几天失效 valid_time_type=RELATIVE时有效且必填只允许增加领取后可用天数

示例值:

valid_time_type

string

可选

有效期类型：枚举值：RELATIVE/FIXED

示例值:

RELATIVE

valid_time_range_to

string

可选

有效期截止时间 valid_time_type=FIXED时有效且必填券有效结束时间格式必须为yyyy-MM-dd HH:mm:ss 只允许延长固定时间的结束时间（支持到分）

示例值:

{}

activity_id

string

活动Id

可选

示例值:

2018xxxx

external_callback_url

string

外部回调地址

可选

示例值:

xxxx

memo

string

备注

可选

示例值:

备注

gmt_end

string

可选

活动结束日期，只可以延长格式要求为：yyyy-MM-dd HH:mm:ss

示例值:

{}

item_ids

array[string]

可选

活动商品列表，只可以增加

示例值:

["2018xxxx","2018xxxx"]

示例

返回响应

🟢200common response

application/json

Body

object {0}

🔴500请求失败

商户查询商品代金券详情

商户查询商品代金券列表