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

# Fiat currency support

By the end of this guide, you'll know how to configure Link to display fiat amounts in your users' preferred currency using the `displayFiatCurrency` parameter.

<Check>
  **Before you start**

  * You have the Mesh SDK initialized and launching (see [Launch the Mesh SDK](/build/launch-sdk))
</Check>

## Overview

Users see fiat-equivalent values in many places throughout Mesh's transfer flows (configuring a transfer, previewing it, etc.). It defaults to USD, but if your app shows fiat values in another currency, it can be jarring for that currency to switch mid-session. You can use the `displayFiatCurrency` parameter in the Mesh SDK to configure this.

## Implementation

### 1. Initialize Link with `displayFiatCurrency`

When you initialize Link in your application, use the `displayFiatCurrency` parameter to specify the desired fiat currency behavior.

<AccordionGroup>
  <Accordion icon="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/icons/web.svg?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=6fd7faf20edd7e5cec27f3550deb55ef" title="Web SDK initialization structure" width="24" height="24" data-path="images/icons/web.svg">
    ```javascript theme={null}
    const connection = createLink({
      ...
      displayFiatCurrency: 'USD',
      ...
    })
    ```
  </Accordion>

  <Accordion icon="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/icons/apple.svg?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=3ea087c17aff5ef105e1f1e3cc39de58" title="iOS Native SDK initialization structure" width="24" height="24" data-path="images/icons/apple.svg">
    ```swift theme={null}
    let settings = LinkSettings(displayFiatCurrency: "USD",
                                ...)
    ```
  </Accordion>

  <Accordion icon="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/icons/android.svg?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=0bbbb8fb34fea77c1a25aaa3c9d5dacc" title="Android Native SDK initialization structure" width="24" height="24" data-path="images/icons/android.svg">
    ```kotlin theme={null}
    val configuration = LinkConfiguration(
      ...
      displayFiatCurrency = "USD",
      ...
    )
    ```
  </Accordion>

  <Accordion icon="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/icons/react.svg?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=162ed81498b01d342d25c427bd7bd5c7" title="ReactNative SDK initialization structure" width="24" height="24" data-path="images/icons/react.svg">
    ```javascript theme={null}
    return <...
            settings={{
              displayFiatCurrency: 'USD',
              ...
            }}
    ```
  </Accordion>

  <Accordion icon="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/icons/flutter.svg?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=efe91e3117513e06731a5bbf7321efd0" title="Flutter SDK initialization structure" width="24" height="24" data-path="images/icons/flutter.svg">
    ```dart theme={null}
    final result = await MeshSdk.show(
      context,
      configuration: MeshConfiguration(
        displayFiatCurrency: 'USD',
        ...
          ),
    ```
  </Accordion>
</AccordionGroup>

### 2. Test your implementation

Thoroughly test your implementation to ensure a seamless experience for your users:

* Verify that Link displays correctly with the fiat currencies you intend to support.

## UI behavior

All fiat amounts in Mesh Link will display in the specified currency.

<div style={{ display: "flex", gap: "1rem", alignItems: "flex-start", flexWrap: "wrap" }}>
  <div style={{ flex: "1 1 45%", minWidth: "280px" }}>
    <Frame>
      <img src="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/image-14.png?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=1034a108f0a77e98771823936bb7ff0e" alt="" width="840" height="1390" data-path="images/image-14.png" />
    </Frame>
  </div>

  <div style={{ flex: "1 1 45%", minWidth: "280px" }}>
    <Frame>
      <img src="https://mintcdn.com/mesh-40/Y-QnDCJ7fcNNqJ5o/images/image-16.png?fit=max&auto=format&n=Y-QnDCJ7fcNNqJ5o&q=85&s=33c50bd6ff4d32c0cdd92d2dbebfc422" alt="" width="852" height="1382" data-path="images/image-16.png" />
    </Frame>
  </div>
</div>

## Supported currencies

If you need a currency that isn't listed below, reach out to your Mesh representative and we'll get it added.

| Status                                                 | Symbol | Currency           |
| ------------------------------------------------------ | ------ | ------------------ |
| <span className="sdk-badge sdk-live">live</span>       | USD    | US Dollar          |
| <span className="sdk-badge sdk-live">live</span>       | EUR    | Euro               |
| <span className="sdk-badge sdk-live">live</span>       | GBP    | British Pound      |
| <span className="sdk-badge sdk-backlog">backlog</span> | CNY    | Chinese Yuan       |
| <span className="sdk-badge sdk-backlog">backlog</span> | JPY    | Japanese Yen       |
| <span className="sdk-badge sdk-backlog">backlog</span> | CHF    | Swiss Franc        |
| <span className="sdk-badge sdk-backlog">backlog</span> | CAD    | Canadian Dollar    |
| <span className="sdk-badge sdk-backlog">backlog</span> | AUD    | Australian Dollar  |
| <span className="sdk-badge sdk-backlog">backlog</span> | KRW    | South Korean Won   |
| <span className="sdk-badge sdk-backlog">backlog</span> | HKD    | Hong Kong Dollar   |
| <span className="sdk-badge sdk-backlog">backlog</span> | INR    | Indian Rupee       |
| <span className="sdk-badge sdk-backlog">backlog</span> | BRL    | Brazilian Real     |
| <span className="sdk-badge sdk-backlog">backlog</span> | MXN    | Mexican Peso       |
| <span className="sdk-badge sdk-backlog">backlog</span> | SGD    | Singapore Dollar   |
| <span className="sdk-badge sdk-backlog">backlog</span> | TRY    | Turkish Lira       |
| <span className="sdk-badge sdk-backlog">backlog</span> | SAR    | Saudi Riyal        |
| <span className="sdk-badge sdk-backlog">backlog</span> | AED    | UAE Dirham         |
| <span className="sdk-badge sdk-backlog">backlog</span> | ZAR    | South African Rand |
| <span className="sdk-badge sdk-backlog">backlog</span> | THB    | Thai Baht          |

## What's next

Both `displayFiatCurrency` and `language` are configured in the same SDK initialization call. See [Multi-language support](/resources/multi-language) for the companion guide on configuring display language, or [Launch the Mesh SDK](/build/launch-sdk) for the full SDK initialization reference across all five platforms.

***

<Accordion title="AI coding reference (llms.txt)">
  *AI coding reference — a compact summary of this page's APIs, parameters, and patterns for use by AI coding assistants (following the [llms.txt standard](https://llmstxt.org/)). Human readers can safely ignore this.*

  **llms.txt — Fiat currency support**

  Configure the `displayFiatCurrency` parameter to display fiat amounts in the user's preferred currency throughout Link.

  **Set in SDK initialization** (all 5 platforms, same parameter name): `displayFiatCurrency: 'USD'`

  **Values**: ISO 4217 currency code. Defaults to `'USD'` if not specified.

  **Currently live**: USD (US Dollar) | EUR (Euro) | GBP (British Pound)

  **Backlog (not yet live)**: CNY, JPY, CHF, CAD, AUD, KRW, HKD, INR, BRL, MXN, SGD, TRY, SAR, AED, ZAR, THB

  **Note**: Affects all fiat-equivalent display values throughout Link (transfer config, preview, etc.). Does not affect which currencies users can transact in — only the display conversion. `displayFiatCurrency` and `language` are set in the same SDK initialization call.
</Accordion>
