# 更新服务卡片扩展信息
接口应在服务器端调用,详细说明参见服务端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 校验不通过 |