Skip to main content

响应结构

error 字段不是固定契约:
  • 含义因响应来源而异:
    • API 接口响应失败时 status="0"、error 为对应错误码(见本页各场景章节);
    • 商户后台与收银台页面响应失败时仅 status="0"、error 保持 00000000(与成功值相同),提示文案在 msg 中;
    • 订单失败时查询接口仍返回 status="1"、error="00000000",实际结果在 data.status 与 data.errorMsg 中
  • 随时可能变动:错误码与错误文案可能随版本迭代新增、调整或改变含义,请勿将 error 码值或 msg 文案直接用于业务结果判断。
成功响应
失败响应(以缺少必填参数为例)

错误信息总览

按场景的错误明细

签名、鉴权与访问权限

验签失败示例

商户能力与入驻状态

必填参数缺失

补齐对应必填字段后重试。字段名以具体接口为准。

参数格式非法

字段格式、长度或取值不符合要求。请对照对应接口页的字段规则修正。

金额与限额

金额超限示例

收款账户信息(代付)

订单相关

密钥与加解密配置

汇率查询

支付方式与银行代码

应用(appId)

系统繁忙与处理超时

凭证 / PDF 生成

订阅

退款

余额与扣款

对账文件

全球收银台

商户后台常见错误

本章错误提示出现在登录与操作商户后台的过程中(非 API 接口返回),请按描述处理;如持续出现,请携带错误提示与错误编码联系 HaiPay 支持。编码为后台服务错误码,与 API 错误码(1001/1002 等)属不同体系;— 表示该提示无独立识别码。

登录与会话

安全验证(MFA 与验证码)

密码管理

子账号与权限

批量付款与凭证

文件与导出中心

后台配置

其他

收银台页面常见错误

本章错误提示出现在收银台 / 收款链接 / 重定向支付页面,面向你的用户(非 API 返回)。此类错误不返回独立错误码:JSON 响应中失败仅以 status 为 0 标识,error 保持 00000000(与成功值相同),提示文案在 msg 中;部分重定向页面直接输出纯文本。如持续出现,请携带提示内容与订单号联系 HaiPay 支持。

订单与订阅

风控与汇率

收款链接

信息收集与 KYC

信用卡

重定向页面

订单失败原因(data.errorMsg)

在代收与代付订单查询接口的 data 中,除订单 status(数字)外还有 errorMsg 字段,表示该笔订单的失败原因原文。该字段描述订单自身的处理结果,可能包含银行或收款方返回的文案。 请根据 data.status 判断订单结果并做相应处理;如需协助,请携带 orderNo 联系 HaiPay 支持。
请勿将 data.errorMsg 当作 API 调用结果。API 调用的成败由顶层 status 与 error 决定;data.errorMsg 描述的是订单业务层的处理结果,二者属于不同层级。

相关主题

最后修改于 2026年10月15日