错误码

更新时间:2026.06.29
||| 安装 Skill
提示:本功能目前处于灰度测试阶段、暂未开放使用,待全量开放后将通过文档门户公告同步,感谢您的理解。

商品券错误码

说明:「外部错误码(code)」和「描述(message)」是接口返回给外部(品牌/服务商)的错误信息,可根据此信息排查问题。

一、错误码速查表

错误码

错误信息

外部错误码(code)

描述(message)

解决方案

 268578088

 服务商验证BM关系失败

 NO_AUTH

 当前品牌尚未授权当前服务商执行此操作

 

 268578101

 入参不合法

 PARAM_ERROR

 参数错误

 

 268578222

 时间格式错误

 PARAM_ERROR

 时间字符串格式错误,请使用 RFC3339 标准格式

 

 268578426

 上传图片为空

 PARAM_ERROR

 参数错误,上传图片为空

 

 268578427

 上传图片过大

 PARAM_ERROR

 参数错误,上传的图片过大

 

 268578428

 未知图片类型

 PARAM_ERROR

 参数错误,上传的图片格式未知或不在支持范围内

 

 268578429

 上传文件SHA值校验不通过

 INVALID_REQUEST

 参数错误,上传的图片与 meta 中的 sha256 值校验不通过

 

 268578430

 图片meta信息不一致

 INVALID_REQUEST

 参数中的 meta 字段与文件的基本信息不一致,请确认文件名是否一致

 

 268578476

 商品券展示信息的商品券原价没有设置

 INVALID_REQUEST

 单品券必须提供商品原价,请补充

 

 268578477

 商品券展示信息的商品券套餐组合没有设置

 INVALID_REQUEST

 单品券必须提供商品券套餐组合信息,请补充

 

 268578478

 商品券单券模式信息的立减券使用规则没有设置

 INVALID_REQUEST

 单券模式下,全场满减券应在商品券中提供满减券使用规则信息

 

 268578479

 商品券单券模式信息的折扣券使用规则没有设置

 INVALID_REQUEST

 单券模式下,全场折扣券应在商品券中提供折扣券使用规则信息

 

 268578481

 商品券批次的券使用规则展示信息中的小程序AppID没有设置

 INVALID_REQUEST

 商品券支持小程序核销时,必须提供「小程序AppID」

 

 268578482

 商品券批次的券使用规则展示信息中的小程序跳转路径没有设置

 INVALID_REQUEST

 商品券支持小程序核销时,必须提供「小程序跳转路径」

 

 268578483

 商品券批次的券使用规则展示信息中的APP跳转路径没有设置

 INVALID_REQUEST

 商品券支持APP核销时,必须提供「APP跳转路径」

 

 268578485

 每周固定使用时间配置当天使用时间段后没有配置每周使用的星期数

 INVALID_REQUEST

 每周固定可用时间(weekly_available_period)中提供当天可用时间段时(day_period_list),每周可用星期数(day_list)必填

 

 268578486

 商品券的单券模式信息没有配置

 INVALID_REQUEST

 单券模式下,全场券需要提供「单券模式信息(single_usage_info)」

 

 268578487

 商品券的次卡模式信息没有配置

 INVALID_REQUEST

 多次优惠模式下必须提供「多次优惠模式信息(sequential_usage_info)」

 

 268578526

 解析openid错误

 INVALID_REQUEST

 传入的OpenID不合法

 

 268578531

 转换品牌ID为uint64失败

 PARAM_ERROR

 参数错误,品牌ID不合法,请确认是微信支付提供的品牌ID

 

 268578633

 分页的页大小过大

 PARAM_ERROR

 分页大小超出限制,请根据接口文档调整到允许的范围

 

 268578640

 输入的商户关联门店ID格式不合法

 PARAM_ERROR

 输入的门店ID格式不合法,请确认是否是微信支付提供的门店ID

 

 268578651

 更新批次发放次数总上限参数不合法

 INVALID_REQUEST

 更新「批次发放次数总上限」时必须同时设置「当前批次发放次数总上限」和「目标批次发放次数总上限」

 

 268578653

 更新批次每日发放次数上限参数不合法

 INVALID_REQUEST

 更新「批次每日发放次数上限」时必须同时设置「当前批次每日发放次数上限」和「目标批次每日发放次数上限」

 

 268579038

 解析page_token错误

 PARAM_ERROR

 page_token 不合法,请确认 page_token 来自于上一个列表查询请求的 next_page_token

 

 268579591

 商品券类型不合法

 INVALID_REQUEST

 全场券的券类型只能设置为「满减券」和「折扣券」,不可以设置为「换购券」

 

 268579803

 没有权限调用本接口

 NO_AUTH

 服务商没有此接口权限

 

 268579815

 单券使用信息不合法

 INVALID_REQUEST

 单品满减券或单品折扣券不应在商品券中设置「满减券使用规则」或「折扣券使用规则」,而是应该在商品券批次中设置

 

 268579829

 批次的次卡使用规则信息不合法

 INVALID_REQUEST

 多次优惠使用模式的商品券批次,应该在「多次优惠使用规则」中包含对应类型的优惠规则,且数量与多次优惠的优惠次数相等

 

 268579830

 批次的单次卡使用规则信息不合法

 INVALID_REQUEST

 单券使用模式的商品券批次,应该在「单券使用规则」中包含对应类型的优惠规则。对于文档中标记不应填写的优惠规则应删除。

 

 268580485

 单券模式下批次未填写 single_usage_rule

 INVALID_REQUEST

 usage_mode 为 SINGLE 时,批次未填写 single_usage_rule

 请填写 single_usage_rule 字段

 268580486

 次卡模式下批次未填写 sequential_usage_rule

 INVALID_REQUEST

 usage_mode 为 SEQUENTIAL 时,批次未填写 sequential_usage_rule

 请填写 sequential_usage_rule

 268580889

 商品券使用模式非法,请根据文档确认使用正确的模式

 INVALID_REQUEST

 商品券使用模式(usage_mode)非法,不可以使此模式

 

 268584135

 批次组的CouponCode模式不合法

 PARAM_ERROR

 批次组的CouponCode模式不合法

 请使用 WECHATPAY 或 UPLOAD CouponCode模式

 268584136

 设置了 wait_days_after_receive 的情况下 available_days 必填

 INVALID_REQUEST

 设置了 wait_days_after_receive 的情况下 available_days 必填

 请补充 available_days 字段

 268584137

 缺少 stock_for_create 字段

 INVALID_REQUEST

 usage_mode 为 SINGLE 的情况下 stock 必传

 请传入 stock 信息

 268584138

 缺少 stock_bundle 字段

 INVALID_REQUEST

 多次优惠模式下缺少 stock_bundle 字段

 补充 stock_bundle 字段

 268584139

 PROGRESSIVE_BUNDLE 模式下 缺少 progressive_bundle_usage_rule

 INVALID_REQUEST

 多次优惠模式下 stock_bundle 必须提供 progressive_bundle_usage_rule

 

 268584141

 批次组的使用规则信息与优惠类型不匹配

 PARAM_ERROR

 批次组的使用规则信息与优惠类型不匹配

 请检查批次组的 progressive_bundle_usage_rule 内容

 268584142

 PROGRESSIVE_MODE 下缺少 progressive_bundle_usage_info 字段

 INVALID_REQUEST

 多次优惠模式(usage_mode=PROGRESSIVE_BUNDLE)下必须提供 progressive_bundle_usage_info

 

 268584156

 内部系统失败

 SYSTEM_ERROR

 系统异常,请稍后重试

 请稍后重试

 268585347

 核销订单的商户号不合法

 INVALID_REQUEST

 核销订单的商户号不合法

 请检查 associated_order_info 中的 mchid 或 sub_mchid 是否正确

 268585349

 根据商户号MchCode查询商户信息逻辑失败

 INVALID_REQUEST

 请求参数中的商户号不合法

 请确认参数中的商户号正确可用

 268588114

 图片生成类型无效

 PARAM_ERROR

 非法的图片生成类型

 请按照文档填写正确的图片生成类型

 268589582

 套餐可选数量大于单品数量

 INVALID_REQUEST

 套餐可选数量不能大于单品列表数量

 套餐中的pick_count字段不能大于choice_list数组的长度,请检查套餐配置

 268591645

 获取类型参数错误

 INVALID_REQUEST

 服务商暂不支持盲盒领取模式,请使用其他发放类型

 请将 issuance_type 修改为其他有效类型后重试

 268591738

 使用规则展示信息口令链接未设置

 PARAM_ERROR

 商品券APP跳转类型为口令链接时,必须提供「口令链接」

 请在 usage_rule_display_info 中设置 passcode_link 字段

 268591739

 使用规则展示信息使用指引未设置

 PARAM_ERROR

 商品券APP跳转类型为使用指引时,必须提供「使用指引」

 请在 usage_rule_display_info 中设置 usage_guide 字段

 268592001

 使用规则展示信息app_jump_type未设置

 PARAM_ERROR

 缺少必填参数app_jump_type

 查看文档填写app_jump_type

 268596825

 券标签重复

 PARAM_ERROR

 coupon_tag_list 中存在重复的标签

 请检查 coupon_tag_list,确保每个标签只出现一次

 268596826

 会员标签缺少会员卡ID

 PARAM_ERROR

 指定 MEMBER 标签时必须提供 member_card_id

 请在 member_tag_info 中填写 member_card_id

反馈
目录
置顶