> ## 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.

# marketCheckoutPreview

> Preview what a shopper would pay at checkout for one order under a market's pricing settings, as the market editor's checkout preview does. Give `id` to start from a saved market, `settings` to try changes before saving them, and `order` to price your own amounts; without `order`, a sample $100 order is used. Nothing is saved. Returns null if no market with that id is owned by the caller. Throws a 400 error with an extension code of INVALID_MARKUP, INVALID_MARKET_SETTINGS or INVALID_PREVIEW_ORDER when the input is invalid.

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

**Store must have one of:** `LANDED_COST`

## Arguments

**id** `ID`

The id of the market whose saved settings to start from. Omit to preview settings alone.

**order** `[MarketCheckoutPreviewOrderInput](/docs/api-reference/v3/reference/markets/market-checkout-preview-order-input)`

The order to price. Defaults to a sample order: price 100, shipping 9.99, duties 8, taxes 4.5 (3.3 without duties) and fees 2.

**fields**

**currency** `String`

The ISO 4217 currency of the amounts. Must match the market's store currency when `id` is given; defaults to it, or to USD without a market.

**duties** `[Decimal](/docs/api-reference/v3/reference/common/decimal)`

The import duties.

**dutyFreeTaxes** `[Decimal](/docs/api-reference/v3/reference/common/decimal)`

The import taxes calculated without duties, charged instead of `taxes` when duties are excluded from checkout. Defaults to `taxes`.

**fees** `[Decimal](/docs/api-reference/v3/reference/common/decimal)`

Brokerage and carrier fees.

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

The product's base price, before markup.

**shipping** `[Decimal](/docs/api-reference/v3/reference/common/decimal)`

The shipping charge. Defaults to 0.

**taxes** `[Decimal](/docs/api-reference/v3/reference/common/decimal)`

The import taxes, calculated on the price plus duties.

**settings** `[MarketCheckoutPreviewSettingsInput](/docs/api-reference/v3/reference/markets/market-checkout-preview-settings-input)`

Settings to preview in place of the saved ones.

**fields**

**breakdownDisplay** `[LandedCostBreakdownDisplay](/docs/api-reference/v3/reference/markets/landed-cost-breakdown-display)`

How uncharged landed-cost lines appear at checkout.

**coveredByMarkup** `[\[LandedCostComponent!\]](/docs/api-reference/v3/reference/markets/landed-cost-component)`

Landed-cost components whose checkout charge the markup absorbs, in order.

**excludedFromCheckout** `[\[LandedCostComponent!\]](/docs/api-reference/v3/reference/markets/landed-cost-component)`

Landed-cost components neither charged nor shown at checkout.

**includedInPrice** `[\[LandedCostComponent!\]](/docs/api-reference/v3/reference/markets/landed-cost-component)`

Landed-cost components baked into the product price.

**markup** `[Decimal](/docs/api-reference/v3/reference/common/decimal)`

The markup on the base price, as a fraction from "0" to "1" with at most 6 decimal places.

**markupStrategy** `[MarketMarkupStrategy](/docs/api-reference/v3/reference/markets/market-markup-strategy)`

How the markup combines with the landed cost.

## Returns

**marketCheckoutPreview** `[MarketCheckoutPreview](/docs/api-reference/v3/reference/markets/market-checkout-preview)`

What a shopper would see at checkout for one order under a market's pricing settings. All amounts are in the store's currency.

**fields**

**lines** `[\[MarketCheckoutPreviewLine!\]!](/docs/api-reference/v3/reference/markets/market-checkout-preview-line)` *required*

The duties, taxes and fees lines of the checkout breakdown, in that order.

**fields**

**charged** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

What the shopper is charged for this component at checkout, after inclusion, exclusion and markup coverage.

**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).

**component** `[LandedCostComponent!](/docs/api-reference/v3/reference/markets/landed-cost-component)` *required*

The landed-cost component.

**display** `[MarketCheckoutPreviewLineDisplay!](/docs/api-reference/v3/reference/markets/market-checkout-preview-line-display)` *required*

How the line appears in the checkout breakdown.

**quoted** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

The component's landed cost before any of the settings apply.

**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).

**productPrice** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

The product price the shopper sees, with the markup and any included landed cost baked in.

**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).

**shipping** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

The shipping charge, as given.

**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).

**total** `[Money!](/docs/api-reference/v3/reference/common/money)` *required*

The order total: product price, shipping and every charged landed-cost line.

**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).

## Example

```graphql theme={null}
query {
  marketCheckoutPreview(id: "...", order: { ... }, settings: { ... })
}
```


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