错误代码格式
错误代码由字母前缀 + 数字组成：| 前缀 | 类别 | HTTP 状态码 |
|---|---|---|
| 0 | 成功 | 200 |
| Axxxxx | 商户相关错误 | 400-401 |
| Bxxxxx | 用户相关错误 | 400 |
| Cxxxxx | 系统相关错误 | 500-503 |
| Dxxxxx | 风控拒绝 | 406 |
| Exxxxx | 未知错误 | 500 |
类别 E 错误（未知错误）：由 Waffo 内部系统或第三方系统中的未知状态导致。商户必须持续查询交易状态，直到返回最终的成功/失败结果。
完整错误代码列表
成功
| 错误代码 | 描述 | HTTP |
|---|---|---|
| 0 | 成功 | 200 |
A - 商户相关错误
| 错误代码 | 描述 | HTTP |
|---|---|---|
| A0001 | API 密钥无效 | 401 |
| A0002 | 签名无效 | 401 |
| A0003 | 参数校验失败 | 400 |
| A0004 | 无权限 | 401 |
| A0005 | 超出商户限额 | 400 |
| A0006 | 商户状态异常 | 400 |
| A0007 | 不支持的交易币种 | 400 |
| A0008 | 超出交易限额 / 支付金额必须在允许范围内 | 400 |
| A0009 | 订单不存在 | 400 |
| A0010 | 商户合同不允许此操作 | 400 |
| A0011 | 幂等参数不匹配错误 | 400 |
| A0012 | 商户账户余额不足 | 400 |
| A0013 | 支付已成功；订单不可取消 | 400 |
| A0014 | 受退款规则限制，不允许退款 | 400 |
| A0015 | 不支持的支付渠道；订单不可取消 | 400 |
| A0016 | 支付渠道拒绝；订单不可取消 | 400 |
| A0017 | 不支持的支付渠道；订单不可退款 | 400 |
| A0018 | 用户无可用支付方式 | 400 |
| A0019 | 因拒付争议，不允许退款 | 400 |
| A0020 | 支付金额超过交易限额 | 400 |
| A0021 | 累计支付金额超过日交易限额 | 400 |
| A0022 | 检测到多个产品；商户必须指定产品名称 | 400 |
| A0023 | Token 已过期；无法创建订单 | 400 |
| A0024 | 汇率已过期；订单无法处理 | 400 |
| A0025 | 周期数必须大于 1 | 400 |
| A0026 | 商户指定的收银台页面语言不受支持 | 400 |
| A0027 | 退款次数已超过最大值 50 | 400 |
| A0028 | 订阅仍在处理中或已失败，管理 URL 不可用 | 400 |
| A0029 | 商户提供的卡数据无效 | 400 |
| A0030 | 无法找到商户提供的卡 BIN | 400 |
| A0031 | 商户提供的卡组织或卡类型不受支持 | 400 |
| A0032 | 商户提供的支付 Token 数据无效 | 400 |
| A0033 | 检测到多个支付方式；商户必须指定支付方式国家 | 400 |
| A0034 | 商户提供的订单过期时间已过期 | 400 |
| A0035 | 当前订单不支持 capture 操作 | 400 |
| A0036 | 当前订单状态不允许 capture 操作 | 400 |
| A0037 | 用户支付 Token 无效或已过期 | 400 |
| A0039 | 订单已由拒付预警服务退款 | 400 |
| A0040 | 订单不能并发创建 | 400 |
| A0041 | 拒付不存在 | 400 |
| A0042 | 拒付状态已是最终状态 | 400 |
| A0043 | 当前状态不允许提交证据 | 400 |
| A0044 | 文件不存在 | 400 |
| A0045 | MIT 交易无法处理，因为 tokenId 状态未验证 | 400 |
| A0046 | 访问被拒绝：请求 IP 不在白名单中 | 401 |
| A0047 | 收银台页面语言格式无效；必须符合 IETF BCP 47：两位 ISO 639-1 语言代码、可选四位 ISO 15924 文字代码，以及可选两位 ISO 3166-1 alpha-2 地区代码 | 400 |
B - 用户相关错误
| 错误代码 | 描述 | HTTP |
|---|---|---|
| B0001 | 用户状态异常 | 400 |
| B0002 | 超出用户限额 | 400 |
| B0003 | 用户余额不足 | 400 |
| B0004 | 用户未在超时时间内完成支付 | 400 |
| B0005 | 用户授权失败 | 400 |
| B0006 | 手机号无效 | 400 |
| B0007 | 邮箱格式无效 | 400 |
| B0008 | Auth code 无效 | 400 |
| B0009 | Auth code 已过期 | 400 |
| B0010 | Auth code 已被使用 | 400 |
| B0011 | Access token 无效 | 400 |
| B0012 | Access token 已过期 | 400 |
| B0013 | Access token 不存在 | 400 |
C - 系统相关错误
| 错误代码 | 描述 | HTTP |
|---|---|---|
| C0001 | 系统错误 | 500 |
| C0002 | 商户合同无效 | 500 |
| C0003 | 订单状态无效；无法进入下一步 | 500 |
| C0004 | 订单信息不匹配错误 | 500 |
| C0005 | 支付渠道拒绝 | 503 |
| C0006 | 支付渠道错误 | 503 |
| C0007 | 支付渠道维护中 | 503 |
D - 风控拒绝
| 错误代码 | 描述 | HTTP |
|---|---|---|
| D0001 | 风控拒绝 | 406 |
| D0002 | 风控交易限额 | 406 |
E - 未知错误
| 错误代码 | 描述 | HTTP |
|---|---|---|
| E0001 | 状态未知 | 500 |