错误码¶
HTTP 状态一览¶
| HTTP | 场景 |
|---|---|
200 |
查询成功;或创建接口幂等键命中 |
201 |
创建收款单成功 |
400 |
请求体/字段校验失败;gateway_id 与 payment_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 为准。