订单退款

API文档最后更新: 2026-10-28

订单退款

通用鉴权、响应、返回字段和错误说明见接入指南。

POST /openapi/v1/seller/orders/12345/refund

参数

类型

必填

说明

message

string

否

退款说明,最多 255 字符

requestNo

string

是

8~48 位字母、数字、下划线或连字符,固定表示本次退款请求

{"message": "同意退款", "requestNo": "seller_refund_20261028_0001"}

按当前权限,对交易成功或部分退款订单退还全部剩余可退金额,不传金额。兑换订单不支持原支付退款。相同 requestNo 重试必须保持说明等请求内容一致;不要为一次超时退款重新生成编号。

成功 data 为订单详情快照。退款异步处理,可能先返回原成功状态或 refundPending=true;继续查询,最终以 status、refundedAmount、refundPending 确认结果。纯供货方不返回买家退款金额。