错误码

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
`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 小时后进行操作

公共

余额

机构

支付

OTC

闪兑

出金

礼品卡

订阅

对账

通知