Approve a return request
Approves only a created request and returns AdminReturnList, without detail-only refund or replacement data. Records resolution and pickup_required without changing requested_settlement. Monetary refunds require an eligible paid order, an available refund mode and verified outbound bank details when needed; amount and allocation are computed by the backend. Credit-line refund approvals create no monetary refund here. Replacement approval does not create a replacement order. Pickup does not gate refunds. A missing request returns 404 before body validation; invalid decisions or state return 400. When the refund can’t be made at that moment (the order’s payments changed since the request was checked, a payment it draws on is held for review in payment exceptions, or refunds are briefly unavailable), the request returns 409 and nothing is approved. Requires store-scoped admin authentication and the runtime orders:returns permission for this operation. Returned item value subtracts prorated coupon and promotion discounts and includes tax once. A mixed return creates separate cash and loyalty-point refunds; a points-only return needs no cash refund mode or bank account. Earlier requested refunds reduce the available balance even while pending. Refunds and the points-credit request are recorded atomically with approval. A refund of a cash or other offline payment in the original mode is manual: done at once when the store marks that payment method paid, else pending until an admin marks it paid or forfeits it.
Authorizations
Body
Approve a created return. Refund value uses original item prices less prorated coupon and promotion discounts, with tax applied to the discounted amount. The returned share of redeemed loyalty points is refunded as points; only the remainder is cash. Each share is capped by its remaining refundable balance. Partial-return points use cumulative whole-point rounding so the final return retains the residual share. Replacement approval does not create a replacement order.
Required and non-null when the return has a cash refund, subject to the order's available refund modes. Optional for points-only returns, which use loyalty-point refunds without bank details. Cleared for replacement or credit-line refund approval.
original-payment-mode, bank-transfer, null