医保支付错误码

一、错误码速查表（TOP 20）

二、错误码详细排查

268529515 — 未找到订单

排查步骤：

1. 检查 mixed_order_id / out_trade_no 是否与下单时一致

2. 检查查询用的商户号是否与下单时一致

268512536 — 订单已存在

排查步骤：

1. 同一 out_trade_no 已下单成功，可取回 prepay_id 继续唤起支付，无需重复下单

2. 重试场景下参数必须与首次完全一致

268510604 — 请确认 sub_appid 与 sub_openid 是否正确

排查步骤：

1. sub_openid 必须通过 sub_appid 获取，不同 AppID 下的 OpenID 不能混用

2. 确认 sub_appid 已与 sub_mchid 完成绑定

268545964 — 亲属关系不存在，请传入有效亲属关系后重试

排查步骤：

1. 引导用户在微信内确认医保亲情账户是否已建立有效绑定

2. 入参中的亲属关系标识、被代付人信息需与亲情账户绑定信息一致

268545962 — 入参用户姓名和医保电子凭证绑卡姓名不匹配

排查步骤：

1. 用户姓名必须与医保电子凭证激活时实名认证的姓名完全一致（包括生僻字、繁简）

268510610 — 医保局结算校验失败

排查步骤：

1. 该错误由医保局返回，请核对 medical_info 中机构 / 科室 / 项目编码是否在医保局备案目录内

2. 检查医保金额、自费金额拆分是否符合当地医保政策

3. 偶发故障可指数退避重试 1-2 次

4. 持续失败联系医保局对接人或微信支付技术支持，并提供 Request-Id

268529489 — 暂不支持当前商户下单，请先完成商户接入流程

排查步骤：

1. 商户需完成医保支付产品权限申请、医保局定点机构备案及对应授权流程

2. 服务商场景下需完成子商户产品授权

268554422 — 医保冲正失败

排查步骤：

1. 不要重复发起退款；通过查询订单接口确认订单当前状态

2. 持续异常时联系医保局对接人或微信支付技术支持，并提供 Request-Id

268531471 — 退款总金额不匹配

排查步骤：

1. total_amount（退款总金额）必须等于 medical_amount（医保退款金额）+ cash_amount（自费退款金额）

2. 各金额单位为分

268435461 — 参数非法

排查步骤：

1. 检查金额字段单位是否为分（非元）

2. 检查时间格式是否为 RFC 3339

3. 检查必填字段、medical_info 中医保编码格式是否符合接口文档

4. 检查是否有不可见字符（如全角空格、BOM 头）

268554200 — 订单状态错误

排查步骤：

1. 当前操作与订单状态不兼容，请先查询订单状态后按状态发起对应操作

268560650 — 已完成验密不允许关单

排查步骤：

1. 已验密订单等待支付结果回调，不要发起关单

2. 如最终支付成功且需取消，请走退款流程

268435462 — 参数过长

排查步骤：

1. 对照接口文档检查字段最大长度

268529477 — 订单总金额不一致

排查步骤：

1. 下单时 amount.total（订单总金额）必须等于 medical_amount + cash_amount

2. 各金额单位为分，自费或医保金额为 0 时也需显式传 0

268529475 — 混合单字段校验失败

排查步骤：

1. 对照接口文档逐字段核对 medical_info 嵌套结构与患者信息字段

2. 患者信息必须与医保电子凭证绑定信息一致

268545963 — 微信号未绑定医保电子凭证

排查步骤：

1. 引导用户在微信内激活医保电子凭证后重试

268545966 — 医保局业务错误：传入用户信息与原订单不匹配

排查步骤：

1. 后续接口的 payer 信息（openid、姓名、身份证、亲属关系等）必须与下单时完全一致

268531511 — 医保订单未支付，无法退款

排查步骤：

1. 仅 SUCCESS 状态的订单可以退款，请先查询订单状态

268545961 — 入参个人身份 ID 摘要和医保电子凭证绑卡身份 ID 摘要不匹配

排查步骤：

1. 身份证号必须与医保电子凭证激活时实名认证的身份证一致

2. 注意身份证号最后一位 X 的大小写

268547120 — pay_auth 请求失败

排查步骤：

1. 偶发故障可指数退避重试 1-2 次

2. 检查商户与医保局对接配置（定点机构编码、密钥等）

3. 持续失败联系医保局对接人或微信支付技术支持