> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: convertCurrency(identifiers: ConvertCurrencyIdentifiers, amounts: Array<DecimalValue>)

# Method package: wixEcomV2

# Method menu location: wixEcomV2 --> currencies --> convertCurrency

# Method Link: https://dev.wix.com/docs/velo/apis/wix-ecom-v2/currencies/convert-currency.md

# Method Description:

Returns an array of amounts converted from the original (`from`) currency to the target (`to`) currency and the timestamp for the conversion rate used.


Use the `convertCurrency()` function to convert an array of one or more amounts between two currencies. The `convertCurrency()` function returns an array of converted amounts and the timestamp for the conversion rate used.

> **Note**:  The currency codes used must exist in the array of supported currencies returned by the [`listCurrencies()`](#listcurrencies) function.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Convert an array of amounts from one currency to another (dashboard page code)

```javascript
import { currencies } from 'wix-ecom.v2';

const identifiers = {
  'from': 'USD',
  'to': 'GBP'
};

const amounts =	[ 
  {
    'decimalPlaces': 2,
    'value': '1000'
  },
  {
    'decimalPlaces': 2,
    'value': '20324'
  } 
];

currencies.convertCurrency(identifiers, amounts)
  .then((convertedAmounts) => {
    const firstConvertedAmount = convertedAmounts.amounts[0];
    const timestamp = convertedAmounts.rateTimestamp;
  });

/* Promise resolves to: 
 * {
 *   "amounts": [
 *     {
 *       "decimalPlaces": 2,
 *       "value": "795"
 *     },
 *     {
 *       "decimalPlaces": 2,
 *       "value": "1616287"
 *     } 
 *   ],
 *   "rateTimestamp": "2023-04-30T21:00:00.277Z"
 * }
 */
```

## Convert an array of amounts from one currency to another (export from backend code)

```javascript
import { Permissions, webMethod } from 'wix-web-module';
import { currencies } from 'wix-ecom.v2';

export const convertCurrency = webMethod(Permissions.Anyone, async (identifiers, amounts) => {
  try {
    const convertedAmounts = await currencies.convertCurrency(identifiers, amounts);
    const firstConvertedAmount = convertedAmounts.amounts[0];
    const timestamp = convertedAmounts.rateTimestamp;

    return convertedAmounts;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
});

const identifiers = {
  'from': 'USD',
  'to': 'GBP'
};

const amounts =	[ 
  {
    'decimalPlaces': 2,
    'value': '1000'
  },
  {
    'decimalPlaces': 2,
    'value': '20324'
  } 
];

convertCurrency(identifiers, amounts)
  .then((convertedAmounts) => {
    const firstConvertedAmount = convertedAmounts.amounts[0];
    const timestamp = convertedAmounts.rateTimestamp;
  });

/* Promise resolves to: 
 * {
 *   "amounts": [
 *     {
 *       "decimalPlaces": 2,
 *       "value": "795"
 *     },
 *     {
 *       "decimalPlaces": 2,
 *       "value": "1616287"
 *     } 
 *   ],
 *   "rateTimestamp": "2023-04-30T21:00:00.277Z"
 * }
 */

```

---