Order Exchange

In this guide, you’ll learn about order exchanges.

Looking for no-code docs? Refer to this Medusa Admin User Guide to learn how to manage an order's exchanges using the dashboard.

What is an Exchange?#

An exchange is the replacement of an item that the customer ordered with another item.

A merchant creates the exchange, specifying which items to return and which new items to send.

The OrderExchange data model represents an exchange.

When an exchange is created, a return, represented by the Return data model, is also created to handle receiving the items back from the customer.

Note: Refer to the Returns guide to learn more about returns and how they work.

The OrderExchangeItem data model represents the new items to be sent to the customer. It's associated with the OrderExchange data model.

An exchange has shipping methods used to send the new items to the customer. They’re represented by the OrderShippingMethod data model.

The shipping methods for the returned items are associated with the exchange's return, as explained in the Returns guide.

The OrderExchange data model has a difference_due property that stores the outstanding amount.

Condition	Result
`difference_due < 0`	The merchant owes the customer a refund of the `difference_due` amount.
`difference_due > 0`	The merchant requires additional payment from the customer of the `difference_due` amount.
`difference_due = 0`	No payment processing is required.

Any payments or refunds made are stored in the OrderTransaction data model.

When an exchange is confirmed, the order’s version is incremented.

Was this page helpful?