# 更新服务卡片扩展信息

调试工具

接口应在服务器端调用,详细说明参见服务端API

# 接口说明

# 接口英文名

setUserNotifyExt

# 功能描述

更新服务卡片扩展信息

# 注意事项

服务卡片详细介绍可参考文章

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/set_user_notifyext?access_token=ACCESS_TOKEN 

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:18

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性 类型 必填 说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token
openid string 用户身份标识符。
当使用微信支付订单号作为 code 时,需要与实际支付用户一致;当通过前端获取 code 时,需要与点击 button 的用户一致。
notify_type number 卡片id。可在文中(1.1)中查阅。
notify_code string 动态更新令牌。获取方式可在文中(1.3或1.4)中查阅。
需要注意的是,微信支付订单号从生成到可被校验存在一定的时延可能,若收到报错为 notify_code 不存在,建议在1分钟后重试。
ext_json string 扩展信息,不同卡片的定义不同,可在文中(1.1中各模版定义链接)中查阅。

# 返回参数

属性 类型 说明
errcode number 错误码
errmsg string 错误信息

# 调用示例

示例说明: 更新扩展信息

# 请求数据示例


{
  "notify_type": 1003,
  "openid": "xxx",
  "notify_code": "xxx",
  "ext_json": "{\"pay_info\":\"{\\\"transaction_id\\\":\\\"4200001855202305090060871147\\\",\\\"pay_amount\\\":2001,\\\"pay_time\\\":1683546394}\",\"store_info\":\"{\\\"store_name\\\":\\\"westore\\\",\\\"store_address\\\":\\\"深圳市南山区南山大道18号\\\",\\\"latitude\\\":22,\\\"longitude\\\":114}\"}" 
}  

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok"
} 

# 错误码

错误码 错误描述 解决方案
40003 invalid openid 不合法的 OpenID ,请开发者确认 OpenID 的有效性
85431 system error 系统繁忙,稍后重试
85434 invalid notify_type notify_type 参数不合法
85436 notify_code abnormal notify_code 异常(被封禁)
85437 invalid notify_code notify_code 不存在
85461 notify_type access deny notify_type 准入驳回
85462 app aceess deny 小程序准入驳回
85470 invalid ext_json ext_json 参数不合法
85471 ext_json has illegal utf8 char ext_json 包含非utf8字符
85444 pay_info check fail pay_info 校验不通过
85445 store_info check fail store_info 校验不通过
85446 shipping_list check fail shipping_list 校验不通过
85447 product_list check fail product_list 校验不通过