> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ReturnShippingOptions

> How the store buys and charges for return shipping labels: the most it will pay for one, when a signature is required, what a label's cost is deducted from, and how items share a label. These are the settings on the merchant app's shipping and returns pages. Several of them change what a label costs the store or what a customer is paid.

**Required scopes:** [`returns_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-returns_read), [`returns_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-returns_write)

**deductLabelFromCredit** `Boolean!` *required*

Whether the cost of the return label is subtracted from the store credit the customer receives. Changes what customers are paid out.

**deductLabelFromExchange** `Boolean!` *required*

Whether the cost of the return label is subtracted from the value applied to an exchange.

**deductLabelFromRefund** `Boolean!` *required*

Whether the cost of the return label is subtracted from the customer's refund. Changes what customers are paid out.

**merchantMaxLabelPrice** `[Money](/docs/api-reference/v3/reference/common/money)`

The most Redo will pay for one return label when the store is the one paying for it. Null means Redo's default cap applies. Customer-paid and Redo-paid labels have their own caps, so this does not affect them. Always in USD.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**onlyCombineLabelsFromSameFulfillment** `Boolean!` *required*

Whether items share one return label only when they shipped in the same original fulfillment. When false, items from different fulfillments can share a label, which costs less but mixes shipments.

**requireSignature** `Boolean!` *required*

Whether a return shipment needs a signature on delivery when the returned items are worth at least `requireSignatureThreshold`. Signature delivery costs more per label. Has no effect while the threshold is null.

**requireSignatureForTags** `Boolean!` *required*

Whether a return shipment needs a signature on delivery when it contains a product with one of `requireSignatureTags`. Signature delivery costs more per label.

**requireSignatureTags** `[String!]!` *required*

Product tags that require a signature when `requireSignatureForTags` is on. Matched without regard to case.

**requireSignatureThreshold** `[Money](/docs/api-reference/v3/reference/common/money)`

The returned items' total value at or above which a signature is required, when `requireSignature` is on. Null means no value triggers it. Always in USD.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.