错误码
更新时间:2026.06.29商品券错误码
说明:「外部错误码(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 |
