查询会员卡模板列表

更新时间：2023.11.28

通过此接口可查询指定某品牌的所有会员卡模板列表

# 接口说明

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

请求方式： 【GET】

请求URL： /v3/marketing/membercard-open/cards

# 请求参数

Query 查询参数

brand_id 选填 string(16)

【品牌ID】 会员卡创建后归属于此品牌ID

appid 必填 string(32)

【商户AppID】 商户的公众号AppID。
1、只能为服务号AppID，不支持App、小程序、订阅号的AppID。
2、该AppID用于获取会员OpenID及unionid。
3、会员相关（会员状态、权益、服务）消息将通过该服务号触达用户
4、该AppID需要与会员卡归属品牌有B-A关系

offset 必填 int

【分页页码】 query分页页码，页码从0开始

limit 必填 int

【分页大小】 分页大小，最大值20

# 返回参数

data 选填 array

【会员卡列表】 符合条件的会员卡列表

数组

need_dynamic_code 选填 boolean

【是否启用动态码】 是否启用动态码功能。若启用，用户会员卡的身份识别码会被系统生成的18位数字取替，动态改变，可有效保障用户的储值资产安全，降低用户因被截图带来的储值盗用风险。

total_count 必填 int

【总数量】 总数量

offset 必填 int

【分页页码】 分页页码

limit 必填 int

【分页大小】 分页大小，最大值20

请求示例

1https://api.mch.weixin.qq.com/v3/marketing/membercard-open/cards?brand_id=1001622624&offset=0&limit=1

返回示例

1{
2    "data":[
3        {
4            "card_id":"pbLatjvWOibDc5-TBnbUk1pD12o0",
5            "create_time":"2020-05-20T13:29:35.120+08:00",
6            "update_time":"2020-05-20T13:29:35.120+08:00",
7            "remain_quantity":20,
8            "status":"NOT_APPROVE",
9            "brand":{
10                "brand_id":"1004",
11                "display_name":"微信支付"
12            },
13            "appid":"wxea9c30890f48d5ae",
14            "logo_url":"https://wxpaylogo.qpic.cn/wxpaylogo/PiajxSqBRaEIPAeia7Imvtsn7sYGNcEj33YzVvJF88ECQ19LXId8ZL2Q/0",
15            "title":"微信支付测试卡",
16            "background_picture_url":"https://wxpaylogo.qpic.cn/wxpaylogo/PiajxSqBRaEIPAeia7Imvtsn7sYGNcEj33YzVvJF88ECQ19LXId8ZL2Q/0",
17            "description":"使用本会员卡表示你同意xxx公司的协议，解释权归xxx公司所有",
18            "service_phone":"010-8877xxxx",
19            "code_type":"BAR_CODE",
20            "total_quantity":5000000,
21            "date_information":{
22                "type":"FIX_TIME_RANGE",
23                "available_begin_time":"2020-05-20T13:29:35.120+08:00",
24                "available_end_time":"2030-05-20T13:29:35.120+08:00",
25                "available_day_after_receive":200,
26                "wait_days_after_receive":2
27            },
28            "code_mode":"SYSTEM_ALLOCATE",
29            "need_display_level":true,
30            "init_level":"白银会员",
31            "out_request_no":"100002322019090134234sfdf",
32            "balance_information":{
33                "need_balance":false,
34                "balance_appid":"wxea9c30890f48d5ae",
35                "balance_path":"pages/balance/balance",
36                "balance_url":"https://xxx.com"
37            },
38            "user_information_form":{
39                "can_modify_after_activate":false,
40                "common_field_list":[
41                    "USER_FORM_FLAG_MOBILE",
42                    "USER_FORM_FLAG_SEX",
43                    "USER_FORM_FLAG_NAME",
44                    "USER_FORM_FLAG_BIRTHDAY"
45                ],
46                "custom_field_list":{
47                    "type":"TEXT",
48                    "name":"喜欢的运动",
49                    "values":[
50                        "篮球",
51                        "足球",
52                        "羽毛球"
53                    ]
54                },
55                "additional_statement":{
56                    "title":"xxx会员卡使用须知",
57                    "url":"https://xxx.111.com",
58                    "appid":"wxea9c30890f48d5ae",
59                    "path":"pages/statement/statement"
60                }
61            }
62        }
63    ],
64    "need_dynamic_code":false,
65    "total_count":20,
66    "offset":1,
67    "limit":20
68}

# 错误码

# 公共错误码

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

# 业务错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户暂无权限使用此功能	请开通商户号权限。请联系产品或商务申请
500	SYSTEM_ERROR	生成二维码链接失败，请重试	系统异常，请使用相同参数稍后重新调用
400	INVALID_REQUEST	扫码投放场景不支持实时code模式	请更换非实时code模式的会员卡再重试
400	INVALID_REQUEST	会员卡的创建商户号不等于调用方商户号	请使用会员卡的创建商户号进行操作
400	INVALID_REQUEST	请先升级会员卡才能使用此功能	请先调用《升级会员卡API》升级会员卡
400	INVALID_REQUEST	AppID非服务号	请使用正确的服务号的AppID重新调用，不支持App、小程序、订阅号。
400	INVALID_REQUEST	会员卡code分配类型不支持修改	会员卡code分配类型为“系统分配”，不支持修改
400	INVALID_REQUEST	会员卡code分配类型不支持修改为“系统分配”	会员卡code分配类型无法修改为“系统分配”。
400	INVALID_REQUEST	储值小程序path为空	请填写储值小程序path
400	INVALID_REQUEST	会员卡ID无效	请检查会员卡ID是否正确填写
400	INVALID_REQUEST	该会员1年内未在本商家有微信支付交易，无法导入	请更换手机号重试
400	INVALID_REQUEST	会员已经领取过该卡	请使用其他会员卡
400	INVALID_REQUEST	会员卡code为实时模式，需要传入卡code	请填入卡code
400	INVALID_REQUEST	积分跳转path为空	请填写积分跳转path
400	INVALID_REQUEST	自助积分跳转path为空	请填写自助积分跳转path
400	INVALID_REQUEST	会员专享价跳转path为空	请填写会员专享价跳转path
400	INVALID_REQUEST	该手机号和会员卡已被导入过	请更换手机号或会员卡ID重试
400	INVALID_REQUEST	该商户号不是会员卡的创建商户号	请使用会员卡的创建商户号进行操作
400	INVALID_REQUEST	手机号未绑定微信号，无法导入	请更换手机号重试
400	INVALID_REQUEST	商户无授权，请重试	请开通商户号权限。请联系产品或商务申请
400	INVALID_REQUEST	该手机号会员卡记录不存在	请更换手机号或会员卡ID重试
400	INVALID_REQUEST	没有符合条件的数据	请使用正确的参数重新调用
400	INVALID_REQUEST	商户号不属于该卡的创建方	请使用会员卡创建方的商户号重新调用
400	INVALID_REQUEST	会员卡已经迁移	会员卡已经迁移，无需重复操作
400	INVALID_REQUEST	会员权益一旦展示无法关闭	会员权益一旦展示无法关闭
400	INVALID_REQUEST	会员储值一旦展示无法关闭	会员储值一旦展示无法关闭
400	INVALID_REQUEST	需要上架至少一个积分权益、优惠权益、服务才可以投放	请先给会员卡上架至少一个积分权益、优惠权益、服务
400	PARAM ERROR	AppID有误	请使用正确的AppID重新调用
400	PARAM ERROR	OpenID有误	请使用正确的OpenID重新调用
400	PARAM ERROR	商户和品牌关系校验失败	请先将商户号绑定到品牌
400	PARAM ERROR	品牌、AppID关系校验失败	请先将AppID绑定到品牌

文档是否有帮助

商户文档

商户文档中心

更多支持

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

查询会员卡模板列表

# 接口说明

# 请求参数

# 返回参数

# 错误码

# 公共错误码

# 业务错误码

关于我们

服务支持

友情链接

客服帮助