If you cannot fulfill the order, you can cancel it and refund the customer. Also the customer can cancel an order via refurbed's ticketing system before you shipped it. Every product sold on refurbed comes with a 35-day trial period that allows for returns, irrespective of the motivation. The customer can request to return their device via refurbed's ticketing system within this timeframe and we will provide the return label automatically. After that period of time, customers can return a device due to warranty reasons. In those cases you need to provide the return label.

All services and operations concerning orders must be called with OrderService or OrderItemService in the URL followed by the command/operation.

All calls must be done using POST method.

❌ Cancellations (`BatchUpdateOrderItemsState` / `UpdateOrderItemsState` & `RefundOrderItem` / `RefundOrder`)

It is mandatory to inform the customer if you cannot fulfill an order by creating a ticket in refurbed’s ticket system.

‣ Update order item state

If you work with order item states, you can change the state to CANCELLED.

‣ Refund the order (item)

Refund the order. More information about full and partial refunds can be found below.

↩️ Returns

Automatic return labels during 35-day trial period (`ListOrderItemReturns`)

Every product sold on refurbed comes with a 35-day trial period that allows for returns, irrespective of the motivation. Here you can find more information about the Automatic Return Labels: Automatic Return Labels .

<aside> ℹ️

The ListOrderItemReturns method replaced the return_initiated filter of the OrderService/ListOrders method.

</aside>

‣ Fetch return requests

You can retrieve all auto-label return requests by calling ListOrderItemReturns. Like all read commands served over our API, you can apply filters and sorting by sending a specific payload in the request header. The response includes order information, such as order and order item IDs and identifiers, as well as return details, including the request date, tracking information, and the reason for the return label request.