---
title: 支付网关错误码定义
keywords: [ERR_TIMEOUT, 超时, 支付网关]
summary: 记录了支付网关所有核心错误码的含义及排查方向
category: api
---

# 支付网关错误码定义

## 1. 超时类错误

### ERR_TIMEOUT
- **含义**：支付网关请求超时
- **常见原因**：网络延迟、第三方服务响应慢
- **排查方向**：检查网络连接、查看第三方服务状态

### ERR_GATEWAY_TIMEOUT
- **含义**：上游网关超时
- **常见原因**：银行接口响应慢
- **排查方向**：联系银行技术支持

## 2. 业务类错误

### ERR_INSUFFICIENT_BALANCE
- **含义**：余额不足
- **常见原因**：用户账户余额不够
- **排查方向**：提示用户充值

### ERR_INVALID_AMOUNT
- **含义**：金额无效
- **常见原因**：金额为负数或超过限额
- **排查方向**：检查金额校验逻辑