Migration Rest Portal

Build Apps

Go Headless

Client

API Preview

Develop Websites

REST

# Currency Converter Service

## About This API
Currency Converter api allows third party apps to get the conversion rate  and convert amounts between currencies
Use this API to:
1. get supported currency list
2. convert an amount to a different currency

#### Learn more about the [service use case](slug::use-case)
  
## Permissions

This API requires the following permission:
`CURRENCY_CONVERTER.READ_CURRENCIES`

## Decimal Value explanation
Decimal_Value is made of 2 fields value and decimal places.
value is limited to the number of digits in a "Long" type, 
meaning the value return has a max number of digits of 17.

for example: the number 1.2345678910111213 will be represented in Decimal_Value as
 { 
    value:  12345678910111213
    decimal_places : 16
 }
 
a number that the unscale version is larger then a Long will be cut to fit 17 digits





# Currency Converter Service

## Use Case
Show the service that the site offers in different currencies.

## Usage Example In WixStores
 * Call currency converter to show the gallery in a different currency from the site currency
 * Call currency converter to show the crt page in a different currency from the site currency


from

ConversionRateRequest

Date and time the conversion rate was last updated.

rateTimestamp

ConversionRateResponse

amounts

ConvertCurrencyRequest

ConvertCurrencyResponse

code

symbol

Currency

CurrencyRate

Decimal places to apply (e.g., for 10.95 decimal_places will be 2).

decimalPlaces

Value without decimals (e.g., for 10.95 value will be 1095).

value

DecimalValue

ListCurrenciesRequest

currencies

ListCurrenciesResponse

nanos

seconds

Timestamp

Returns all currencies currently supported by Wix.

Manage Currencies

ListCurrencies

Returns a list of converted amounts, from the original (from) currency to the target (to) currency.

ConvertCurrency

Returns the conversion rate between 2 currencies.

ConversionRate

Currency Rate

Permission Scopes

Syntax

Permission Scopes

Syntax

Permission Scopes

Syntax