导入加密手机号提醒会员领卡

更新时间：2026.01.13

如商户有存量注册会员未领取会员卡，可导入最近一年在品牌内有微信支付交易的活跃会员手机号（需加密后才能导入），导入后微信将通过卡包提醒用户将会员卡领取到卡包。

接口说明

适用对象：服务商

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

请求方式：POST

path 指该参数为路径参数

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

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

请求参数

参数名

变量

类型[长度限制]

必填

描述

会员信息

member_information

object

是

body 用户注册的会员卡信息

属性

加密手机号

encrypted_phone_number

string[1,512]

是

body 注册会员的手机号码（加密请参考敏感信息加密方法）
示例值：vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWYSs2bLtG9tj+bdJn4WSCPzqSyXnFbzaaKSE2j4mAFON3kzNexb/SYkHZNJAuCittaW4wpGj7U+h9A==

自定义场景值

outer_str

string[1,128]

否

body 自定义场景值，商户可以用于标记投放场景，如门店／来源等。只能录入数字及中英文／半角标点
匹配正则表达式: ^[0-9a-zA-Z\u0000-\u00FF\u4e00-\u9fa5]+$
示例值：my_card_CARD

请求示例

1{
2  "member_information": {
3    "card_id": "pbLatjvWOibDc5-TBnbUk1pD12o0",
4    "code": "478515832665",
5    "membership_number": "316510891298",
6    "registration_time": "2015-05-20T13:29:35.120+08:00"
7  },
8  "encrypted_phone_number": "vvysDQeEaH3I+wRh14St0abIkvQyFgh/fbWYSs2bLtG9tj+bdJn4WSCPzLhShNHgujZzseiL6sYmT7E65mv/eFeTa7yslYfrX0hrhHazSM/+tfvN/C3OZwiBbcrF9LTIIdBVhGOqhCx0gK5YAVZc8dbW/yJqC5i79PDfVYJtpQe3A4v/GiDa2Q+Mv03taxgnEkzqlSPjkXiCYBj9UaFJ4bqCTXiO2Kt6TpczvAaZW+9/blxiJwqEFXe78LbrIQvkDUmVdZbqBdPQ+QGQgc/2Ea4IbP/EEt1qSyXnFbzaaKSE2j4mAFON3kzNexb/SYkHZNJAuCittaW4wpGj7U+h9A==",
9  "outer_str": "my_card_CARD"
10}

返回参数

处理成功，应答无内容

返回示例

1
2无数据（Http状态码为204）
3

错误码

公共错误码

状态码	错误码	描述	解决方案
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版)开发者社区微信开放平台微信公众平台腾讯客服