激活会员卡(跳转型激活)

更新时间:2023.11.28

如果商家选择跳转激活的投放方式,用户跳转至商家H5网页/小程序后,商家可调用激活会员卡接口激活会员

注意

  • 会员激活成功后将有事件通知回调到给商家。

# 接口说明

支持商户: 【普通商户】

请求方式: 【POST】

请求URL: /v3/marketing/membercard-open/cards/{card_id}/codes/{code}/activate

# 请求参数

    Path 路径参数
  • card_id 必填 string(32)
    【会员卡ID】 商户创建微信会员卡模板成功后系统返回的会员卡模板ID
  • code 必填 string(32)
    【会员卡code】 领取会员卡后用户获得的code
    Body 包体参数
  • membership_number 选填 string(32)
    【会员卡编号】 在用户会员卡上展示的会员卡编号,如不填写,默认使用会员卡code作为membership_number。只能录入数字/英文/半角标点

# 返回参数

处理成功,应答无内容

请求示例

1{
2 "membership_number": "316510891298"
3}

返回示例

1204
2
3处理成功,应答无内容

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
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绑定到品牌
反馈
咨询
目录