# Order Refunds

Manages refund processing for orders and bags.

### Overview

Use the `financial_status` value on a bag object to determine if there are any associated refunds.

* A `financial_status` of `REFUNDED` will indicate the full order has amount has been refunded.
* A `financial_status` of `PARTIALLY_REFUNDED` will indicate that an amount less than the full order amount has been refunded.

**Returns**

* A merchant may associate a return with a refund. To determine if this has occurred look for a `fulfillment_status` of `RETURNED` and a `financial_status` of `REFUNDED` or `PARTIALLY_REFUNDED`.
* A merchant may also initiate a return without also performing a refund. This scenario is common for exchanges. To determine if this has occurred look for a `fulfillment_status` of `RETURNED` and a `financial_status` that is not `REFUNDED` or `PARTIALLY_REFUNDED`.

### Determine Bag Return and Refund Status

Use the `financial_status` value on a bag object to determine if there are any associated refunds:

* A `financial_status` of `REFUNDED` indicates the full bag amount has been refunded.
* A `financial_status` of `PARTIALLY_REFUNDED` indicates that an amount less than the full bag amount has been refunded.

#### Identify Returns Without Refunds

To determine if a bag has been returned but not refunded (common for exchanges), check for:

* `fulfillment_status` of `RETURNED`
* `financial_status` that is not `REFUNDED` or `PARTIALLY_REFUNDED`

json

```json
{
  "id": "123456789",
  "order_id": "987654321",
  "fulfillment_status": "RETURNED",
  "financial_status": "PAID",
  "status": "COMPLETED"
}
```

#### Returns With Refunds

When a return is associated with a refund, you'll see:

* `fulfillment_status` of `RETURNED`
* `financial_status` of either `REFUNDED` or `PARTIALLY_REFUNDED`

json

```json
{
  "id": "123456789",
  "order_id": "987654321",
  "fulfillment_status": "RETURNED",
  "financial_status": "REFUNDED",
  "status": "COMPLETED"
}
```

#### Business Rules

* A bag with `RETURNED` fulfillment status and `PAID` financial status indicates the item was returned without a monetary refund being processed.
* Merchants commonly use this pattern for exchanges where the customer receives store credit or a replacement item.

Use these endpoints to process refunds and retrieve refund information.

**Available endpoints:**

```
POST /v1/orders/{order_id}/bags/{bag_id}/refunds
 GET /v1/orders/{order_id}/refunds
 GET /v1/orders/{order_id}/bags/{bag_id}/refunds
 GET /v1/orders/{order_id}/refunds/{refund_id}
```