> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误码

> 汇总 GatePay 常见错误码、错误含义与建议处理方式。

| HTTP 状态码 | 错误码 | 描述 | 解决方案 |
| - | - | - | - |
| `500` | `300000` | 系统错误 | 系统异常，请用相同参数重新调用 |
| `500` | `300001` | 内部错误 | 系统异常，请用相同参数重新调用 |
| `500` | `400000` | 未知错误 | 系统异常，请用相同参数重新调用 |
| `200` | `400001` | 请求参数格式错误 | 检查请求数据参数和格式 |
| `200` | `400002` | 签名校验失败 | 检查商户签名是否正确 |
| `200` | `400003` | 请求时间戳超时 | 检查请求 head 里的时间戳字段 |
| `200` | `400004` | API 身份密钥无效 | 请检查请求头 `GatePay-Api-Key` 是否正确配置 |
| `200` | `400005` | 客户端标识无效 | 请检查请求头 `GatePay-Client-Id` 是否正确 |
| `200` | `400007` | 不支持的 media type | 查看接口设置的 media type |
| `200` | `400020` | 签名随机数错误 | 请检查随机数是否为空 |
| `200` | `400201` | 商户订单号重复 | 请核实商户订单号是否重复提交 |
| `200` | `400202` | 订单不存在 | 请检查订单是否发起过交易或订单号是否正确 |
| `200` | `400203` | 商户号不存在 | 请检查商户号是否正确 |
| `200` | `400204` | 订单状态不正确 | 检查订单是否过期、取消或被关闭，可调查询接口 |
| `200` | `400205` | 无效币种 | 请检查下单币种类型 |
| `200` | `400304` | 退款单 ID 不存在 | 检查请求的退款单 ID |
| `200` | `400305` | 商户渠道信息不存在 | 请核实 channelId 是否正确且未被删除 |
| `200` | `400603` | 订单超时 | 请核实订单是否过期 |
| `200` | `400604` | 退款关联交易单无效 | 请检查退款交易单是否为完成状态 |
| `200` | `400605` | 支付账户余额不足 | 支付账户余额不足 |
| `200` | `400607` | 退款次数太多 | 退款次数大于限制 |
| `200` | `400608` | 退款金额异常 | 请检查退款金额 |
| `200` | `400620` | 订单重复支付 | 请核实商户订单号是否重复提交 |
| `200` | `400621` | 错误的支付金额 | 检查请求金额 |
| `200` | `400622` | 汇率波动导致币种兑换失败 | 可以重试再次申请 |
| `200` | `400623` | 不支持币种支付 | 请检查支付币种 |
| `200` | `400624` | 无效订单状态通知地址 | 检查商户提供回调地址是否有效 |
| `200` | `400701` | 同一用户同产品已存在有效订阅 | 请确认是否已存在同产品的有效订阅 |
| `200` | `400702` | 商户未开通渠道支付权限 | 请确认商户是否已开通对应渠道支付权限 |
| `200` | `500008` | 未找到对应商户 | 检查请求商户 ID 是否正确 |
| `200` | `500100` | 支付二维码过期 | 重新下单生成新二维码 |
| `200` | `500101` | 二维码重复支付 | 请核实订单状态 |
| `200` | `500103` | 地址支付闪兑币种错误 | 闪兑受汇率影响 |
| `200` | `500203` | 地址支付无法查询到订单详情 | 请检查地址是否正确 |
| `200` | `500204` | 退款单的退款接收人 ID 无效 | 请确认退款接受人为 Gate 用户 |
| `200` | `500205` | 退款单币种不匹配 | 请保证退款币种为订单币种或用户支付币种之一 |
| `200` | `500206` | 退款金额超过上限 | 请检查订单退款金额 |
| `200` | `500207` | 地址支付无法查询到退款单 | 请确认是否发起退款成功或查询地址是否正确 |
| `200` | `500208` | 不能以转换地址的方式退还无转换地址的订单 | 请确认退款订单类型 |
| `200` | `550307` | OTC交易额度超限 | 请通过以下页面补充信息提升额度 [https://www.gate.com/otc/global\_apply/add\_info](https://www.gate.com/otc/global_apply/add_info) |
| `200` | `550008` | 子账号状态异常 | 建议稍后用相同参数重试，若持续失败请联系技术支持 |
| `200` | `550018` | 风控引擎拒绝该笔交易 | 请检查交易特征或联系运营沟通咨询 |
| `200` | `550020` | 请求来源 IP / 地区命中制裁名单 | 请更换合规网络环境 |
| `200` | `550143` | 附加费金额无效 | 请调整附加费为非负数，且不超过配置的上限比例 |
| `200` | `550200` | 机构代操作权限不足 | 请确认是否传入 `X-GatePay-On-Behalf-Of` 且以自有商户身份发起 |
| `200` | `550203` | 容差金额无效 | 请确保容差金额 ≥0 且小于应付金额 |
| `200` | `550205` | 金额精度无效 | 请核对订单金额与附加费的小数精度是否符合要求 |
| `200` | `5502724` | 渠道名称包含非法字符 | `channelId` 仅允许中英文、数字、下划线、连字符、空格，请移除特殊字符后重试 |
| `200` | `5502740` | 子账号不支持创建订单 | 请使用主账号或具备相应权限的账号发起 |
| `200` | `5502761` | 请求信息冲突 | 请使用不同的商户订单号，或以相同参数幂等重试 |
| `200` | `5504080` | 安全项变更限制 24 小时内超限 | 请在安全项变更 24 小时后进行操作 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.