获取用户信息(跳转型激活)

更新时间:2023.11.28

如果商家的会员卡激活类型设置为“跳转激活”,则需要商户侧异步调用会员卡激活接口来实现用户会员卡的开通。

若用户点击开卡后,跳转至商家H5网页时,则微信会在跳转链接activate_url后拼接若干个参数,包括:用户的OpenID、加密的会员code(encrypt_code)、激活ticket(activate_ticket)。

对于参数中的activate_ticket,商家可调用当前API来获取用户的开卡信息。

# 接口说明

支持商户: 【普通商户】

请求方式: 【GET】

请求URL: /v3/marketing/membercard-open/activate-informations/{activate_ticket}

# 请求参数

    Path 路径参数
  • activate_ticket 必填 string(256)
    【激活ticket】 会员卡激活ticket,可用来查询用户填写的信息

# 返回参数

  • nickname 选填 string(32)
    【微信昵称】 用户的微信昵称
  • head_image_url 选填 string(128)
    【微信头像URL】 用户的微信头像URL
  • user_information 选填 object
    【用户开卡时填写的个人信息】 用户开卡时填写的个人信息
    • 属性

请求示例

1https://api.mch.weixin.qq.com/v3/marketing/membercard-open/activate-informations/abcdefg

返回示例

1{
2 "nickname": "周星星",
3 "head_image_url": "https://xxx.jpg",
4 "user_information": {
5 "common_field_list": [
6 {
7 "name": "USER_FORM_FLAG_MOBILE",
8 "value": "深圳",
9 "custom_field_list": {
10 "name": "喜欢的运动",
11 "value": "篮球",
12 "value_list": [
13 "羽毛球,足球,乒乓球"
14 ]
15 }
16 }
17 ]
18 }
19}

# 错误码

# 公共错误码

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

# 业务错误码

状态码 错误码 描述 解决方案
403 NO_AUTH 商户暂无权限使用此功能 请开通商户号权限。请联系产品或商务申请
500 SYSTEM_ERROR 生成二维码链接失败,请重试 系统异常,请使用相同参数稍后重新调用
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绑定到品牌
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
反馈
咨询
目录