错误码
错误码
业务错误返回 HTTP 200，code 为 0，msg 为可读原因。请原样记录 msg —— 找客服时对方一定先问这个。
最后更新 2026-10-24
常见失败
绝大多数对接问题出在下面六种。
| msg | 原因 | 处理 |
|---|---|---|
| 缺少必要参数 | 必填参数未传或为空 | 对照参数表检查；空字符串等同未传 |
| 商户不存在 | 商户 ID 无效 | 用数字商户 ID，不要用登录名 |
| 商户已被禁用 | 账户被管理员禁用 | Telegram 联系我们 |
| 签名验证失败 | 拼接顺序错或密钥错 | 重新核对该接口的签名公式 |
| 暂无可用通道 | 没有匹配金额或业务类型的通道 | 稍后重试，或询问通道覆盖情况 |
| 余额不足 | 代付金额超过可用余额 | 先查 getBalance；冻结余额不可用 |
哪些情况不算错误
订单处于待支付（status 1）不是错误。只有用户操作或订单过期，才会变成 2 或 3。
代付处于审核中（status 0）不是卡住。审核是出款前的正常阶段。