设置支付后展示的积分到账

更新时间:2023.11.28

商户调此接口,若已设置支付后展示积分,且该笔订单对应的积分已到账,则可以入参积分对应的交易商户号+商户订单号将该笔支付后展示的积分状态设置为“已到账”

# 接口说明

支持商户: 【普通商户】

请求方式: 【PATCH】

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

# 请求参数

    Path 路径参数
  • card_id 必填 string(32)
    【会员卡ID】 商户创建微信会员卡模板成功后系统返回的会员卡模板ID
  • code 必填 string(32)
    【会员卡code】 领取会员卡后用户获得的code
    Body 包体参数
  • out_trade_no 必填 string(32)
    【商户订单号】 商户订单号是商户系统进行下单的内部订单号。
  • mchid 必填 string(32)
    【直连商户号】 直连商户的商户号,由微信支付生成并下发。直连模式必填。
    注意:仅适用于直连商户
  • bonus_value 必填 int
    【会员积分值】 本次积分变更值,本次支付订单完成后在支付结果页和弹窗展示的积分变更值,变更值需要为正数

# 返回参数

处理成功,应答无内容

请求示例

1{
2 "out_trade_no": "1217752501201407033233368018",
3 "mchid": "1230000109",
4 "bonus_value": 30
5}

返回示例

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 会员卡ID无效 请检查会员卡ID是否正确填写
400 INVALID_REQUEST 会员卡的创建商户号不等于调用方商户号 请使用会员卡的创建商户号进行操作
400 INVALID_REQUEST 没有开通会员积分权益服务 请先调用开通权益接口商家会员积分权益
400 INVALID_REQUEST 商户号无效 请检查直连商户号或子商户号是否正确填写
400 INVALID_REQUEST 商户号和品牌关系校验失败 请先将直连商户号或子商户号绑定到会员卡的品牌
400 INVALID_REQUEST code不存在 请检查会员卡code是否正确填写
400 INVALID_REQUEST 用户会员卡无效 用户会员卡已删除,先恢复会员卡再操作
反馈
咨询
目录