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

# Price

> Complete guide to managing prices with e-CROSS

## Pricing models

e-CROSS supports two pricing models that determine how prices are managed and localized across sales channels. Choose the model that best fits your business needs.

### Payout pricing (a.k.a "origin" pricing)

In the payout pricing model, you define the price you want to receive, net of all expenses and fees, for each sale, then e-CROSS automatically localizes it to all the connected sales channels ensuring the final retail price will be enough to cover all expenses and fees and result in the desired payout.

* You define prices in your **foreign currency** (e.g., USD, EUR), only one
* e-CROSS automatically **localizes** these prices for each connected sales channel
* Final retail prices are calculated automatically based on:
  * Exchange rates
  * Taxes and duties
  * International logistics cost (shipment, insurance, etc.)
  * Operational fees (e.g. e-CROSS fee, marketplace fee, payment gateway fee, etc.)
* Localized prices are integrated with the connected sales channels

### Destination pricing

In the destination pricing model, you are in charge of you price positioning strategy for all the connected sales channels, meaning, you define the final retail price per sales channel and country, and the price you sent is the one that will be displayed to the customer in the sales channel.

In this model, e-CROSS performs the *reverse localization* process to estimate the payout value, so you have an estimate of your payout for each sale.

* You define **final retail prices** in the destination country's currency, per sales channel and country
* e-CROSS performs **"reverse localization"** to estimate payout values
* Prices are integrated with the connected sales channels as-is

<Note>
  The reverse localization provides only an estimate. The real payout value will be calculated based on the checkout value of orders.
</Note>

## Updating prices

### Origin pricing workflow

<Steps>
  <Step title="Prepare price data">
    Determine the `listPrice` (optional, for promotions) and `salePrice` (required) in your foreign currency.
  </Step>

  <Step title="Update prices">
    Use the [Update Price (Origin) API](/api-reference/merchant-catalog/update-price-origin) for each SKU.
  </Step>

  <Step title="Check prices">
    Optionally, use the [Get SKU Price API](/api-reference/merchant-catalog/get-sku-price) to check the localized prices.
  </Step>
</Steps>

### Destination pricing workflow

<Steps>
  <Step title="Determine final prices">
    Calculate the final retail price for each sales channel and country.
  </Step>

  <Step title="Update prices">
    Use the [Update Price (Destination) API](/api-reference/merchant-catalog/update-price-destination) for each SKU, sales channel, and country combination.
  </Step>

  <Step title="Check prices">
    Optionally, use the [Get SKU Price API](/api-reference/merchant-catalog/get-sku-price) to check the reverse localized prices.
  </Step>
</Steps>

### Asynchronous Processing

Price updates are processed **asynchronously**:

* The API performs online validation
* Price localization is queued for processing
* Changes may take time to reflect due to sales channel caching mechanisms

## Best Practices

<Tip>
  Update e-CROSS as soon as possible after SKU price changes to minimize the time it takes to reflect in sales channels, as each sales channel front-end has different caching mechanisms.
</Tip>
