Order Exchange

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

What is an Exchange?#

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

A merchant creates the exchange, specifying the items to be replaced and the new items to be sent.

The OrderExchange data model represents an exchange.

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

Note: Learn more about returns in this guide.

The OrderExchangeItem data model represents the new items to be sent to the customer.

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 this guide.

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

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

Any payment or refund made is stored in the Transaction data model.

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

Was this page helpful?