Skip to main content
启润支付使用标准 HTTP 状态码来表示 API 请求的成功或失败。

HTTP 状态码

错误响应格式

发生错误时,响应体包含以下 JSON 结构:
error 对象仅在验证错误(400)时出现。其他错误类型只包含 codemessage

常见错误

400 错误请求

请求体或参数无效时返回。

401 未认证

API 密钥缺失或无效时返回。

404 未找到

请求的资源不存在时返回。

429 请求过多

超过 API 频率限制(每分钟 100 次请求)时返回。
在你的集成中实现指数退避策略,以优雅地处理频率限制。

成功响应格式

成功的响应始终包含 code: 0message: "success"
对于分页接口,data 字段包含 itemspagination