# Exchange Orders


The **Exchange Orders** API is used to place an order in your e-commerce platform when the shopper has chosen to exchange for a replacement item or receive their refund via a gift card.
Your endpoint should handle all tax and shipping calculations.  The endpoint should be idempotent, using `original_order_id` as the key.  Only one exchange order can be placed against an `original_order_id`.

**When it is used:**

- Optoro POSTS an **Exchange Orders** message to you when the shopper has confirmed an exchange, selected a gift card refund, or both.

#### Instant Exchange
This is an exchange of one or more items for a variant of the product (ex: different size, different color). This will be represented in the `items` array by an object like the following:

```json
{
  "sku": "888812345678",
  "quantity": 2,
  "title": "Fuzzy red t-shirt",
  "unit_price_amount_cents": 100,
  "product_amount_cents": 200,
  "discount_amount_cents": 20,
  "tax_amount_cents": 100,
  "product_identifier": "1234-5678",
  "variant_identifier": "1234-5678",
  "original_sku": "888812345678",
  "original_item_identifier": "1234",
  "concept": "acme"
}
```

#### Instant Gift Card
This is an exchange of one or more items for a gift card. This will be represented in the `items` array by an object like the following:

```json
{
  "sku": "OPTOROGIFTCARD",
  "quantity": 1,
  "unit_price_amount_cents": 800,
  "bonus_credit_amount_cents": 200,
  "return_items": [
    {
      "title": "Pink Shirt",
      "original_sku": "888812349672",
      "original_item_identifier": "4567",
      "quantity": 1,
      "concept": "acme"
    }
  ]
}
```

`sku` will be the agreed upon value for an Instant Gift Card exchange and `return_items` will be the list of items being exchanged for the gift card.


Version: 2.0.0

## Download OpenAPI description

[Exchange Orders](https://developer.optoro.com/_bundle/openapi/exchange_orders/@2/openapi.yaml)

## Other

### Create Exchange Order

 - [POST /exchange_orders](https://developer.optoro.com/openapi/exchange_orders/openapi/other/exchange_orders.md)