修改及查询商品券信息
修改商品券
品牌方可以通过该接口修改商品券信息。注:修改只会对新发的券生效,历史已经发放给用户的券不会改变。
请求参数 | 类型 | 描述 |
---|---|---|
product_coupon_id | string | 商品券ID |
json | object | 声明请求的JSON 数据结构 |
brand_id | string | 品牌ID |
out_request_no | string | 修改请求单号 |
display_info | object | 展示信息 |
name | string | 商品券名称 |
image_url | string | 商品券图片 |
background_url | string | 商品券背景图 |
detail_image_url_list | string[] | 商品券详情图列表 |
original_price | integer | 商品原价 |
combo_package_list | object[] | 套餐组合 |
name | string | 套餐名 |
pick_count | integer | 可选单品数量 |
choice_list | object[] | 单品列表 |
name | string | 单品名称 |
price | integer | 单品价格 |
count | integer | 单品数量 |
image_url | string | 单品图片 |
mini_program_appid | string | 单品跳转小程序AppID |
mini_program_path | string | 单品跳转小程序路径 |
php
$instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->patchAsync([
'product_coupon_id' => '1000000013',
'json' => [
'brand_id' => '120344',
'out_request_no' => '34657_20250101_123456',
'display_info' => [
'name' => '全场满100立打8折',
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'background_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
'original_price' => 10000,
'combo_package_list' => [[
'name' => '咖啡2选1',
'pick_count' => 3,
'choice_list' => [[
'name' => '美式',
'price' => 10000,
'count' => 2,
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'mini_program_appid' => 'wx4fd12345678',
'mini_program_path' => '/pages/index/index',
],],
],],
],
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->patchAsync([
'product_coupon_id' => '1000000013',
'json' => [
'brand_id' => '120344',
'out_request_no' => '34657_20250101_123456',
'display_info' => [
'name' => '全场满100立打8折',
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'background_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
'original_price' => 10000,
'combo_package_list' => [[
'name' => '咖啡2选1',
'pick_count' => 3,
'choice_list' => [[
'name' => '美式',
'price' => 10000,
'count' => 2,
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'mini_program_appid' => 'wx4fd12345678',
'mini_program_path' => '/pages/index/index',
],],
],],
],
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->patchAsync([
'product_coupon_id' => '1000000013',
'json' => [
'brand_id' => '120344',
'out_request_no' => '34657_20250101_123456',
'display_info' => [
'name' => '全场满100立打8折',
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'background_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
'original_price' => 10000,
'combo_package_list' => [[
'name' => '咖啡2选1',
'pick_count' => 3,
'choice_list' => [[
'name' => '美式',
'price' => 10000,
'count' => 2,
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'mini_program_appid' => 'wx4fd12345678',
'mini_program_path' => '/pages/index/index',
],],
],],
],
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->patch([
'product_coupon_id' => '1000000013',
'json' => [
'brand_id' => '120344',
'out_request_no' => '34657_20250101_123456',
'display_info' => [
'name' => '全场满100立打8折',
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'background_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
'original_price' => 10000,
'combo_package_list' => [[
'name' => '咖啡2选1',
'pick_count' => 3,
'choice_list' => [[
'name' => '美式',
'price' => 10000,
'count' => 2,
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'mini_program_appid' => 'wx4fd12345678',
'mini_program_path' => '/pages/index/index',
],],
],],
],
],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->patch([
'product_coupon_id' => '1000000013',
'json' => [
'brand_id' => '120344',
'out_request_no' => '34657_20250101_123456',
'display_info' => [
'name' => '全场满100立打8折',
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'background_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
'original_price' => 10000,
'combo_package_list' => [[
'name' => '咖啡2选1',
'pick_count' => 3,
'choice_list' => [[
'name' => '美式',
'price' => 10000,
'count' => 2,
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'mini_program_appid' => 'wx4fd12345678',
'mini_program_path' => '/pages/index/index',
],],
],],
],
],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->patch([
'product_coupon_id' => '1000000013',
'json' => [
'brand_id' => '120344',
'out_request_no' => '34657_20250101_123456',
'display_info' => [
'name' => '全场满100立打8折',
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'background_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'detail_image_url_list' => ['https://wxpaylogo.qpic.cn/wxpayl'],
'original_price' => 10000,
'combo_package_list' => [[
'name' => '咖啡2选1',
'pick_count' => 3,
'choice_list' => [[
'name' => '美式',
'price' => 10000,
'count' => 2,
'image_url' => 'https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx',
'mini_program_appid' => 'wx4fd12345678',
'mini_program_path' => '/pages/index/index',
],],
],],
],
],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典 | 类型 | 描述 |
---|---|---|
product_coupon_id | string | 商品券ID |
state | string | 商品券状态AUDITING | EFFECTIVE | DEACTIVATED 枚举值之一 |
brand_id | string | 品牌ID |
scope | string | 优惠范围ALL | SINGLE 枚举值之一 |
type | string | 商品券类型NORMAL | DISCOUNT | EXCHANGE 枚举值之一 |
usage_mode | string | 使用模式SINGLE | SEQUENTIAL 枚举值之一 |
single_usage_info | object | 单券模式信息 |
normal_coupon | object | 满减券使用规则 |
threshold | integer | 门槛金额 |
discount_amount | integer | 固定减免金额 |
discount_coupon | object | 折扣券使用规则 |
threshold | integer | 门槛金额 |
percent_off | integer | 固定减免百分比 |
sequential_usage_info | object | 多次优惠模式信息 |
type | string | 多次优惠规则类型INCREMENTAL | EQUAL 枚举值之一 |
count | integer | 可使用次数 |
available_days | integer | 多次优惠有效天数 |
interval_days | integer | 多次优惠使用间隔天数 |
display_info | object | 展示信息 |
name | string | 商品券名称 |
image_url | string | 商品券图片 |
background_url | string | 商品券背景图 |
detail_image_url_list | string[] | 商品券详情图列表 |
original_price | integer | 商品原价 |
combo_package_list | object[] | 套餐组合 |
name | string | 套餐名 |
pick_count | integer | 可选单品数量 |
choice_list | object[] | 单品列表 |
name | string | 单品名称 |
price | integer | 单品价格 |
count | integer | 单品数量 |
image_url | string | 单品图片 |
mini_program_appid | string | 单品跳转小程序AppID |
mini_program_path | string | 单品跳转小程序路径 |
out_product_no | string | 外部商品ID |
deactivate_request_no | string | 失效请求单号 |
deactivate_time | string | 失效时间 |
deactivate_reason | string | 失效原因 |
参阅 官方文档
查询商品券
品牌方可以通过该接口查询商品券的详细信息,但不包括商品券的批次信息。
请求参数 | 类型 | 描述 |
---|---|---|
product_coupon_id | string | 商品券ID |
query | object | 声明请求的查询参数 |
brand_id | string | 品牌ID |
php
$instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->getAsync([
'product_coupon_id' => '1000000013',
'query' => [
'brand_id' => '120344',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->getAsync([
'product_coupon_id' => '1000000013',
'query' => [
'brand_id' => '120344',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->getAsync([
'product_coupon_id' => '1000000013',
'query' => [
'brand_id' => '120344',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->marketing->partner->productCoupon->productCoupons->_product_coupon_id_->get([
'product_coupon_id' => '1000000013',
'query' => [
'brand_id' => '120344',
],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}')->get([
'product_coupon_id' => '1000000013',
'query' => [
'brand_id' => '120344',
],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}']->get([
'product_coupon_id' => '1000000013',
'query' => [
'brand_id' => '120344',
],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典 | 类型 | 描述 |
---|---|---|
product_coupon_id | string | 商品券ID |
state | string | 商品券状态AUDITING | EFFECTIVE | DEACTIVATED 枚举值之一 |
brand_id | string | 品牌ID |
scope | string | 优惠范围ALL | SINGLE 枚举值之一 |
type | string | 商品券类型NORMAL | DISCOUNT | EXCHANGE 枚举值之一 |
usage_mode | string | 使用模式SINGLE | SEQUENTIAL 枚举值之一 |
single_usage_info | object | 单券模式信息 |
normal_coupon | object | 满减券使用规则 |
threshold | integer | 门槛金额 |
discount_amount | integer | 固定减免金额 |
discount_coupon | object | 折扣券使用规则 |
threshold | integer | 门槛金额 |
percent_off | integer | 固定减免百分比 |
sequential_usage_info | object | 多次优惠模式信息 |
type | string | 多次优惠规则类型INCREMENTAL | EQUAL 枚举值之一 |
count | integer | 可使用次数 |
available_days | integer | 多次优惠有效天数 |
interval_days | integer | 多次优惠使用间隔天数 |
display_info | object | 展示信息 |
name | string | 商品券名称 |
image_url | string | 商品券图片 |
background_url | string | 商品券背景图 |
detail_image_url_list | string[] | 商品券详情图列表 |
original_price | integer | 商品原价 |
combo_package_list | object[] | 套餐组合 |
name | string | 套餐名 |
pick_count | integer | 可选单品数量 |
choice_list | object[] | 单品列表 |
name | string | 单品名称 |
price | integer | 单品价格 |
count | integer | 单品数量 |
image_url | string | 单品图片 |
mini_program_appid | string | 单品跳转小程序AppID |
mini_program_path | string | 单品跳转小程序路径 |
out_product_no | string | 外部商品ID |
deactivate_request_no | string | 失效请求单号 |
deactivate_time | string | 失效时间 |
deactivate_reason | string | 失效原因 |
参阅 官方文档