错误码

HTTP 状态一览

HTTP	场景
200	查询成功；创建接口幂等键命中；上传或更正运单成功
201	创建收款单成功
400	请求体/字段校验失败；gateway_id 与 payment_methods 同传；列表接口参数缺失或与 retry_of 原单不一致
401	鉴权失败
404	订单不存在或不属于当前商户；创建时 retry_of 无效
409	merchant_order_id 冲突；retry_of 指向的订单已支付；物流写入时状态、转换关系或并发冲突
413	上传运单请求体超过 16 KiB
422	当前订单参数无法创建收款单；指定通道不可用；物流订单未支付或发生同商户跨客户重复冲突
429	限流
503	服务暂时不可用

错误响应体通常为：

{ "error": "..." }

上传运单固定返回 { "error": "...", "code": "..." }，机器码包括 invalid_request、payload_too_large、unauthorized、order_not_found、child_order_id、order_not_paid、shipping_conflict、order_state_conflict、conversion_conflict、write_busy、rate_limited、internal_error。429 同时带 Retry-After。

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