跳转至

错误码

HTTP 状态一览

HTTP 场景
200 查询成功;或创建接口幂等键命中
201 创建收款单成功
400 请求体/字段校验失败;gateway_idpayment_methods 同传;列表接口参数缺失或与 retry_of 原单不一致
401 鉴权失败
404 订单不存在或不属于当前商户;创建时 retry_of 无效
409 merchant_order_id 冲突;或 retry_of 指向的订单已支付
422 当前订单参数无法创建收款单(如地区/币种/金额组合不受支持);或指定的 gateway_id 不可用 / 与前序失败单同一收款账号
429 限流
503 服务暂时不可用

错误响应体通常为:

{ "error": "..." }

请以 HTTP 状态码与 error 文案为准做分支处理;业务终态请以查询结果或 Webhook 中的 order.status / event 为准。