处理订单

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

处理订单

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

POST /openapi/v1/admin/orders/process

参数

类型

必填

说明

orderIds

integer[]

是

订单 ID 数组，1～100 项；单笔也传数组

status

string

是

目标状态，见接入指南的“字段与状态”一节；能否执行取决于当前订单状态

message

string

否

处理说明，最多 255 字符，默认空

processStart

number

否

进度起点，默认 0

processCurrent

number

否

当前进度，默认 50

processTarget

number

否

目标进度，默认 100；充值成功时进度归为 100/100

refundType

string

退款时

full 表示剩余可退金额全退；partial 表示按指定金额退款

currentRefundAmount

number

部分退款时

本次退款金额，人民币元

totalRefundedAmount

number

否

本次完成后的累计退款金额；须等于已退加本次金额，通常省略由服务端计算

commissionRefundType

string

否

noForce 默认不强制追回佣金；force 按平台规则追回

requestNo

string

退款时是

8～48 位字母、数字、下划线或连字符，作为同一管理员、同一订单退款的稳定请求编号

refundRecord

object

否

兼容退款记录，可传 refundNo；一般省略，平台生成退款单号。自定义单号最长 64 位，仅字母、数字、下划线或连字符

充值成功或本地卡密出库：

{"orderIds": [12345], "status": "success", "message": "处理完成"}

更新处理进度：

{"orderIds": [12345], "status": "processing", "processStart": 0, "processCurrent": 30, "processTarget": 100, "message": "正在处理"}

成功订单全额退款示例：

{"orderIds": [12345], "status": "refunded", "refundType": "full", "requestNo": "refund_20261028_0001", "message": "同意退款"}

部分退款示例：

{"orderIds": [12345], "status": "partially_refunded", "refundType": "partial", "currentRefundAmount": 2.5, "requestNo": "refund_20261028_0002", "message": "部分退款"}

待处理、处理中的订单可按原资格提交 status=canceled。需要取消并退款时，同时传 refundType、requestNo 及对应退款参数；不能把单纯状态改变当成资金已退。退款提交成功不等于资金已经退回；通过订单详情的 status、refundedAmount、refundFailure 确认结果。

响应 data 是结果数组，不是分页容器：

{
  "code": 0,
  "message": "success",
  "data": [
    {"id": 12345, "orderNo": "D26102812345678901", "currentStatus": "pending", "result": "success", "message": "处理成功"},
    {"id": 12346, "result": "failure", "message": "订单不存在或不在本地订单范围"}
  ],
  "requestId": "req_example"
}

退款受理项可能带 taskId。result=success 表示该项操作已执行或已受理；退款的最终结果仍以订单详情为准。批量请求可部分成功，不承诺结果顺序与输入顺序一致，必须按 id 对应。

同一退款超时重试保留原 requestNo 及全部退款参数；改变说明、金额、状态等内容应使用新的请求编号。普通处理不使用 requestNo 作为通用幂等键，应先确认详情中的当前状态，再决定是否继续处理。终态订单重复处理可返回单项失败，不会再次出库。

上一篇下一篇