> ## Documentation Index
> Fetch the complete documentation index at: https://86d.store/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-currency

> Display and accept multiple currencies in 86d. Daily exchange-rate sync and per-product currency overrides.

<Warning>
  **Experimental.** This Module has no test or production evidence recorded yet. Read it, run it locally, and hold off on real Orders. See [maturity levels](/docs/resources/versioning).
</Warning>

The Multi-currency [Module](/docs/concepts/modules) lets a [Store](/docs/resources/glossary#store) sell in more than one currency. Catalog prices stay in the store's primary currency; the Module computes display prices in the [Shopper](/docs/resources/glossary#shopper)'s chosen currency from current exchange rates. When the payment provider supports it, the charge itself uses that currency. You can also set a per-product override for any price you do not want derived from an exchange rate.

**Source:** [`modules/multi-currency`](https://github.com/86d-store/86d/tree/main/modules/multi-currency) · **npm:** [`@86d-store/multi-currency`](https://www.npmjs.com/package/@86d-store/multi-currency)

## Installation

```sh theme={null}
86d module add multi-currency
```

## Configuration

```ts theme={null}
multiCurrency({
  primary: "USD",
  enabled: "USD,EUR,GBP,JPY",
  ratesProvider: "exchangerate-host",  // or "openexchangerates"
  refreshHours: "24",
});
```

## Components

* `<CurrencyPicker />`: [Storefront](/docs/concepts/storefront) currency selector.

## Admin endpoints

| Method | Path                              | Description                 |
| ------ | --------------------------------- | --------------------------- |
| `GET`  | `/admin/multi-currency/rates`     | Current rates               |
| `POST` | `/admin/multi-currency/refresh`   | Force refresh               |
| `POST` | `/admin/multi-currency/overrides` | Per-product price overrides |

## Related pages

* [Tax](/docs/modules/tax)
* [Payments](/docs/modules/payments)
* [Price lists](/docs/modules/price-lists)
* [Versioning and maturity](/docs/resources/versioning)
* [Glossary](/docs/resources/glossary)