# Enhanced Currency Conversion Calculator
source: https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/index.md

## Overview {#overview}

The Enhanced Currency Conversion Calculator is a subscription-based service that provides access to Mastercard's daily currency conversion rates and historical currency conversion rates. Additionally, the API provides electronic access to European Central Bank (ECB) reference rates that European Economic Area (EEA) issuing customers may require for the purposes of compliance with EU Regulation 2019 / 518.

Effective 19 April 2020, Issuers located in the EEA will be required to disclose to their cardholders through an electronic platform (for example, website, online app, and so on) the % mark-up between their FX rates, including any issuer related fees, and the exchange rate published by the European Central Bank (ECB) for the same currency pair.

## How It Works {#how-it-works}

![](https://static.developer.mastercard.com/content/enhanced-currency-conversion-calculator/uploads/standard-hwa.png)

Enhanced Currency Conversion Calculator API offers 4 services:

**Conversion-rate-summary**: Provides Mastercard currency conversion rate, calculated cardholder billing amount, the ECB reference rate and the calculated percentage difference between Mastercard and ECB rate for the provided currency pair.
Diagram currencyconv

**Conversion-rate-issued**: Helps determine if the present day's Mastercard and ECB conversion rates are available. Refer to the \[Support\]( /documentation/support/) section for more information on the Mastercard and ECB rate publication schedule.
Diagram ratepublicationstatus

**Mastercard-currencies**: Provides a list of Mastercard currencies for which Mastercard publishes a rate.

**ECB-currencies**: Provides the list of currencies for which the ECB publishes an euro foreign exchange reference rate.
Diagram currencies

## Before You Start {#before-you-start}

**Registration** : To access the production environment you need to be registered as a Mastercard issuing customer. As a Mastercard customer you will have what is called a Interbank Card Association (ICA) Number, a customer ICA that identifies your organization internally in Mastercard. If you are an existing Mastercard customer, but don't know your ICA, you can find it by logging into [Mastercard Connect](https://www.mastercardconnect.com/).

**Regional Availability**: The API is available to Mastercard issuers in the European Economic Area (EEA)

**Pricing**: Issuers will be charged a quarterly subscription fee of EUR 1,250 for access to and use of the Enhanced Currency Conversion API. Please refer to AN 3493 available on Mastercard Connect \> Technical Resource Center for more information

## Good to Know {#good-to-know}

The Enhanced Currency Converter API provides the currency conversion rate from the transaction currency to cardholder billing currency. You will be required to provide the respective currencies for each currency conversion rate you wish to retrieve. To try this API quickly, use [API Reference](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/api-reference/index.md) to send requests directly from your browser to the Sandbox, you are not required to create a Mastercard Developers project and keys to try it out.

The Enhanced Currency Conversion Calculator APIs use authentication. You set up the required keys when you create your Mastercard Developers project for this service. For more information about authentication and the keys, see [API Basics](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/api-basics/index.md).

Mastercard recommends that you use a group email address when creating your project to ensure that team members can access the Mastercard Developers account used for testing and production.

## Next Steps {#next-steps}

To learn more about the Enhanced Currency Conversion Calculator refer to the following guides:

|                                                                Category                                                                 |                                           Description                                           |
|-----------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| [API Basics](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/api-basics/index.md)                | Authentication, API environments and keys.                                                      |
| [Use Cases](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/use-cases/index.md)                  | Common use cases and their implementations including high level and detailed sequence diagrams. |
| [Tutorials \& Guides](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/tutorials-guides/index.md) | Tutorials \& Guides for easy integration.                                                       |
| [API Reference](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/api-reference/index.md)          | Try the Sandbox APIs directly from your browser.                                                |
| [Reference Application](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/reference-app/index.md)  | Reference Application that can be downloaded.                                                   |
| [Parameters](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/parameters/index.md)                | Requests and responses for each endpoint.                                                       |
| [Code and Formats](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/code-and-formats/index.md)    | Error codes and the formats we use.                                                             |
| [Support](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/support/index.md)                      | FAQs and support.                                                                               |