hostingpay-preorder-h5-pc-errors.md

# H5、PC 预下单错误码与排查

> 本页只记录用户提供的最新官方文档中明确列出的常见错误码。更多通用错误码请结合 `references/hostingpay-error-codes.md` 一起看。

## 常见错误码

| 返回码 | 返回描述 | 处理 |
|--------|----------|------|
| `90000000` | 生成微信 Scheme 失败，`errcode[40001]`，`access_token` 无效或不是最新 | 小程序配置有变更、失效或被微信侧限制时常见；需要重新检查并配置小程序 |
| `99010002` | 预下单请求流水重复 | 生成新的 `req_seq_id` 后重试 |

## 排查顺序

1. 先看 `resp_code` 和 `resp_desc`，不要只看 HTTP 200。
2. 若是 `99010002`，优先确认请求流水号生成策略是否保证“同一商户、同一天唯一”。
3. 若是渠道类错误，核对 `trans_type` 和对应渠道对象是否同时完整。
4. 若同步返回成功但支付失败，继续看异步通知和查询接口结果，不要在预下单阶段直接判终态。

## 额外说明

- `jump_url` 为空通常不是前端问题，而是预下单业务本身失败，应回到同步返回体排查。
- 选择单一 `trans_type` 时，如果缺少对应渠道扩展字段，汇付侧可能直接拒绝生成可用支付页。