查询活动详情

更新时间：2023.11.28

查出活动ID对应的活动详情

# 接口说明

支持商户： 【普通服务商】

请求方式： 【GET】

请求URL： /v3/marketing/membercard-activity/activities/{activity_id}

# 请求参数

Path 路径参数

activity_id 必填 string(16)

【活动ID】 创建活动后返回，活动的主键，唯一定义此资源的标识

# 返回参数

activity_id 必填 string(16)

【活动ID】 活动的主键，唯一定义此资源的标识

activity_status 必填 string(16)

【活动的当前状】 活动的当前状态：
CREATED：已创建，调用创建活动API成功后该活动状态
ONGOING：运行中，当活动正式开始的时候活动状态
TERMINATED：已终止，调用终止活动API接口活动状态变
OVER_TIME：已过

create_time 选填 string(32)

【创建时间】 创建会员卡的时间
遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2020-05-20T13:29:35.120+08:00表示北京时间2020年05月20日13点29分35秒。

update_time 选填 string(32)

【更新时间】 更新时间
遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2020-05-20T13:29:35.120+08:00表示北京时间2020年05月20日13点29分35秒。

card_id 必填 string(32)

【会员卡ID】 商户创建微信会员卡模板成功后系统返回的会员卡ID

activity_name 必填 string(10)

【活动名称】 活动名称，用于内部管理，不对外展示。不超过10个字符

activity_type 必填 string(32)

活动类型 活动类型：
NON_MEMBER_AFTERPAY：支付后开卡有礼活动（说明：非会员用户在商户侧消费完成后，可曝光在微信支付成功页面的开卡有礼活动）
MEMBER_AFTERPAY：支付后老会员有礼活动（会员用户在商户侧消费完成后，可曝光在微信支付成功页面的老会员有礼活动）
NON_MEMBER_MINIPROGRAM：支付前场景开卡有礼活动（说明：覆盖扫码/小程序场景，对于非会员用户，访问开卡组件时可看到开卡有礼活动信息，开卡后获得对应优惠券）
MEMBER_MINIPROGRAM：支付前场景老会员有礼活动（说明：覆盖扫码/小程序场景，对于会员用户，访问开卡组件时可直接获得活动设置的优惠券）

begin_time 必填 string(32)

【活动开始时间】 活动开始时间，最长可以配置1年内的活动，活动有效期最长90天
遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒。

end_time 必填 string(32)

【会员卡背景图】 活动结束时间，最长可以配置1年内的活动，活动有效期最长90天
遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒。

award_send_period 选填 object

【发放时间段】 活动时段，可选择活动有效期内部分日期或部分时间段

属性

stock_list 必填 array

【优惠券列表】 发放的优惠券，一个活动最多支持发放3个批次

数组

out_request_no 必填 string(64)

【商户请求单号】 商户凭据号。商户自定义，注意保持唯一性，仅供参考的格式：商户ID+日期+流水号。可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。

pay_activity_setting 选填 object

【支付后活动设置】 支付后活动的相关配置。当活动类型是NON_MEMBER_AFTERPAY或者MEMBER_AFTERPAY时，必填

属性

miniprogram_activity_setting 选填 object

【支付前会员活动设置】 支付前会员活动设置，当活动类型为：NON_MEMBER_MINIPROGRAM或MEMBER_MINIPROGRAM时，可选填

属性

请求示例

1https://api.mch.weixin.qq.com/v3/marketing/membercard-activity/activities/371067

返回示例

1{
2  "activity_id": "371067",
3  "activity_status": "ONGOING",
4  "create_time": "2015-05-20T13:29:35.120+08:00",
5  "update_time": "2015-05-20T13:29:35.120+08:00",
6  "card_id": "pbLatjvWOibDc5-TBnbUk1pD12o0",
7  "activity_name": "良品铺子回馈活动",
8  "activity_type": "NON_MEMBER_AFTERPAY",
9  "begin_time": "2020-01-20T13:29:35.120+08:00",
10  "end_time": "2020-01-29T13:29:35.120+08:00",
11  "award_send_period": {
12    "award_send_time": [
13      {
14        "begin_time": "2020-01-21T00:00:00.000+08:00",
15        "end_time": "2020-01-27T00:00:00.000+08:00"
16    }
17    ],
18    "award_send_day_time": [
19    {
20          "begin_day_time": {
21            "hours": 9,
22            "minutes": 34,
23            "seconds": 6
24      },
25          "end_day_time": {
26              "hours": 9,
27              "minutes": 34,
28              "seconds": 6
29            }
30          }
31      ]
32
33  },
34  "stock_list": [
35    {
36      "stock_creator_mchid": "10000022",
37      "stock_id": "98065001"
38    }
39  ],
40  "out_request_no": "100002322019090134234sfdf",
41  "pay_activity_setting": {
42    "logo_url": "https://wxpaylogo.qpic.cn/wxpaylogo/PiajxSqBRaEIPAeia7Imvtsn7sYGNcEj33YzVvJF88ECQ19LXId8ZL2Q/0",
43    "activity_second_title": "湖南麻辣美食券",
44    "mchid_list": [
45      "10000022",
46      "10000023"
47    ],
48    "activate_setting": {
49      "activate_type": "AUTO_ACTIVATE",
50      "activate_url": "https://w.url.cn/s/Ahz3p2C",
51      "activate_miniprogram": {
52        "activate_appid": "wxea9c30a90fs8d3fe",
53        "activate_path": "pages/activate/activate"
54      }
55    },
56    "payment_setting": {
57        "payment_mode": {
58          "payment_scene_list": [
59            "APP"
60          ]
61      },
62         "limit_bank": "CFT",
63         "goods_tags": [
64            "xxx",
65            "yyy"
66          ]
67        }
68  },
69"miniprogram_activity_setting": {
70    "outer_str": [
71     "领取渠道1",
72     "领取渠道2"
73     ],
74    "award_jump_deploy": {
75      "mini_program_appid": "wxc0b84a53ed8e8d29",
76      "mini_program_path": "mall/pages/List",
77      "button_text": "点击"
78    }
79  }
80}

# 错误码

# 公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

# 业务错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户暂无权限使用此功能	请开通商户号权限。请联系产品或商务申请
400	INVALID_REQUEST	活动创建方未被授权发放此商家券批次	请先调用API授权活动创建方发放当前商家券批次
400	INVALID_REQUEST	活动曝光商户号需要绑定到会员卡品牌	请先将活动商户号绑定到品牌
400	INVALID_REQUEST	活动创建方需要和会员卡归属品牌号绑定	请先将活动创建方商户号绑定到品牌
400	INVALID_REQUEST	请先升级会员卡才能使用此功能	请先调用《升级会员卡API》升级会员卡
400	INVALID_REQUEST	当前会员卡是实时传入code模式，不支持	请更换非实时code模式的会员卡再重试

文档是否有帮助

商户文档

商户文档中心

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

查询活动详情

# 接口说明

# 请求参数

# 返回参数

# 错误码

# 公共错误码

# 业务错误码

关于我们

服务支持

友情链接

客服帮助