查询用户单张券详情
服务商可通过该接口查询微信用户卡包中某一张商家券的详情信息。
| 请求参数 | 类型 | 描述 |
|---|---|---|
| coupon_code | string | 券code |
| appid | string | 公众账号ID |
| openid | string | 用户标识 |
php
$instance->v3->marketing->busifavor->users->_openid_->coupons->_coupon_code_->appids->_appid_->getAsync([
'coupon_code' => '',
'appid' => '',
'openid' => '',
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance->chain('v3/marketing/busifavor/users/{openid}/coupons/{coupon_code}/appids/{appid}')->getAsync([
'coupon_code' => '',
'appid' => '',
'openid' => '',
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance['v3/marketing/busifavor/users/{openid}/coupons/{coupon_code}/appids/{appid}']->getAsync([
'coupon_code' => '',
'appid' => '',
'openid' => '',
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$response = $instance->v3->marketing->busifavor->users->_openid_->coupons->_coupon_code_->appids->_appid_->get([
'coupon_code' => '',
'appid' => '',
'openid' => '',
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance->chain('v3/marketing/busifavor/users/{openid}/coupons/{coupon_code}/appids/{appid}')->get([
'coupon_code' => '',
'appid' => '',
'openid' => '',
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance['v3/marketing/busifavor/users/{openid}/coupons/{coupon_code}/appids/{appid}']->get([
'coupon_code' => '',
'appid' => '',
'openid' => '',
]);
print_r(json_decode((string) $response->getBody(), true));| 返回字典 | 类型 | 描述 |
|---|---|---|
| stock_name | string | 商家券批次名称 |
| belong_merchant | string | 批次归属商户号 |
| comment | string | 批次备注 |
| goods_name | string | 适用商品范围 |
| stock_type | string | 批次类型(NORMAL:固定面额满减券批次 DISCOUNT:折扣券批次 EXCHANGE:换购券批次)NORMAL | DISCOUNT | EXCHANGE 枚举值之一 |
| coupon_use_rule | object | 核销规则 |
| coupon_available_time | object | 券可核销时间 |
| available_begin_time | string | 开始时间 |
| available_end_time | string | 结束时间 |
| available_day_after_receive | integer | 领取后N天内有效 |
| available_week | object | 固定周期有效时间段 |
| week_day | integer[] | 可用星期数(0代表周日,1代表周一,以此类推)0 | 1 | 2 | 3 | 4 | 5 | 6 枚举值之一 |
| available_day_time | object[] | 当天可用时间段 |
| begin_time | integer | 当天可用开始时间 |
| end_time | integer | 当天可用结束时间 |
| irregulary_avaliable_time | object[] | 无规律的有效时间段 |
| begin_time | string | 开始时间 |
| end_time | string | 结束时间 |
| fixed_normal_coupon | object | 固定面额满减券使用规则 |
| discount_amount | integer | 优惠金额 |
| transaction_minimum | integer | 消费门槛 |
| discount_coupon | object | 折扣券使用规则 |
| discount_percent | integer | 折扣比例 |
| transaction_minimum | integer | 消费门槛 |
| exchange_coupon | object | 换购券使用规则 |
| exchange_price | integer | 单品换购价 |
| transaction_minimum | integer | 消费门槛 |
| use_method | string | 核销方式(OFF_LINE:线下滴码 MINI_PROGRAMS:线上小程序 PAYMENT_CODE:微信支付付款码 SELF_CONSUME:用户自助)OFF_LINE | MINI_PROGRAMS | PAYMENT_CODE | SELF_CONSUME 枚举值之一 |
| mini_programs_appid | string | 小程序appid |
| mini_programs_path | string | 小程序path |
| custom_entrance | object | 自定义入口 |
| mini_programs_info | object | 小程序入口 |
| mini_programs_appid | string | 商家小程序appid |
| mini_programs_path | string | 商家小程序path |
| entrance_words | string | 入口文案 |
| guiding_words | string | 引导文案 |
| appid | string | 商户公众号appid |
| hall_id | string | 更多优惠入口;营销馆创建地址 |
| store_id | string | 可用门店id |
| code_display_mode | string | code展示模式 |
| display_pattern_info | object | 样式信息 |
| description | string | 使用须知 |
| merchant_logo_url | string | 商户logo |
| merchant_name | string | 商户名称 |
| background_color | string | 背景颜色Color010 | Color020 | Color030 | Color040 | Color050 | Color060 | Color070 | Color080 | Color090 | Color100 枚举值之一 |
| coupon_image_url | string | 券详情图片 |
| finder_info | object | 视频号相关信息 |
| finder_id | string | 视频号ID |
| finder_video_id | string | 视频号视频ID |
| finder_video_cover_image_url | string | 视频号封面图 |
| coupon_code | string | 券code |
| coupon_state | string | 券状态SENDED | USED | EXPIRED 枚举值之一 |
| stock_id | string | 批次号 |
| transferable | boolean | 是否允许转赠 |
| shareable | boolean | 是否允许分享链接 |
| send_request_no | string | 发券请求单号 |
| use_request_no | string | 核销请求单号 |
| available_start_time | string | 券可使用开始时间 |
| expire_time | string | 券过期时间 |
| receive_time | string | 券领券时间 |
| use_time | string | 券核销时间 |