通过加密手机号查询会员领卡状态

更新时间：2026.01.13

商户可查询导入成功的加密手机号是否已被用户领取。

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/marketing/membercard-open/phonenumber-member/search

请求方式：GET

path 指该参数为路径参数

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
会员卡id	card_id	string[1, 32]	是	query 商户创建微信会员卡模板成功后系统返回的会员卡模板id 示例值：pbLatjvWOibDc5-TBnbUk1pD12o0
加密手机号	encrypted_phone_number	string[1, 512]	是	query 加密的会员手机号，仅支持境内手机号，每次查询支持1个号码,加密请参考敏感信息加密方法示例值：vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWYSs2bLtG9tj+bdJn4WSCPzLyXnFbzaaKSE2j4mAFON3kzNexb/SYkHZNJAuCittaW4wpGj7U+h9A==

请求示例

1https://api.mch.weixin.qq.com/v3/marketing/membercard-open/phonenumber-member/search?card_id=pbLatjvWOibDc5-TBnbUk1pD12o0&encrypted_phone_number=vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWYSs2bLtG9tj+bdJn4WSCPzLyXnFbzaaKSE2j4mAFON3kzNexb/SYkHZNJAuCittaW4wpGj7U+h9A==

返回参数

参数名

变量

类型[长度限制]

必填

描述

用户领取状态

receive_status

string[1,16]

是

该手机号对应的微信用户是否领取会员卡，根据曝光领取情况有以下状态：
UNSHOWED：未曝光
UNRECEIVED：未领取
RECEIVED：已被领取
示例值：RECEIVED

用户会员卡信息

user_card_information

object

否

用户领取会员卡信息,只有状态为已添加才有

属性

返回示例

1{
2  "receive_status": "RECEIVED",
3  "user_card_information": {
4    "code": "478515832665",
5    "openid": "oHdb05U3pYMGsKSVAHN8AhIGhJaA",
6    "unionid": "oHdb05U3p11ahKSVAHN8AhIGhJaA",
7    "receive_time": "2015-05-20T13:29:35.120+08:00",
8    "card_appid": "wx0c44f7dee34b04d1",
9    "card_id": "pbLatjvWOibDc5-TBnbUk1pD12o0"
10  }
11}

错误码

公共错误码

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

文档是否有帮助

LLM请查看llms.txt

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服