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

## Overview {#overview}

The Mastercard Standard Currency Conversion Calculator enables issuers (for example, financial institutions, fintechs) to access daily cardholder currency conversion rates for cross-border payments when the transaction currency differs from the cardholder's billing currency.

The Standard Currency Conversion API utilizes transaction currency, transaction amount, cardholder billing currency and bank fee to provide the applicable currency conversion rate and the calculated cardholder billing amount.
In return, the issuers can present the information to their cardholders within their website or online banking application.
Note: The API is available in NA (North America), LAC (Latin America), MEA (Middle East and Africa), Europe \[Excluding EEA\] and AP (Asia Pacific) regions. For issuers in European Economic Area (EEA), see [Enhanced Currency Conversion Calculator API](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/ "Enhance Currency Conversion Calculator")

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

The standard Currency Conversion Calculator provides a simple equation to generate daily conversion rates for cross border payments.

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

The Standard Currency Converter Calculator API offers the following three services:

* **Conversion Rate:**

Provides transaction details including date, transaction currency and amount, cardholder billing currency and issuer specific mark up to determine the applicable currency conversion rate and cardholder billing amount. To integrate using the reference app, refer [Conversion Rate Tutorial](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/howitworks/index.md#conversion-rate)
Diagram currencyconv

In addition, you can also use the following services as reference when you want to create your digital solution using the Currency Conversion service.

* **Conversion Rate Issued** : Provides status update if the present day Mastercard currency conversion rates are issued. Mastercard rates are published daily and effective for 24 hours. To integrate using the reference app, refer to [Conversion Rate Issued Tutorial](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/howitworks/index.md#conversion-rate-issued)

Diagram ratepublicationstatus

<!-- -->

* **Currencies** : Provides a list of currencies for which Mastercard publishes currency conversion rates. To integrate using the reference app, refer [Currencies Tutorial](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/howitworks/index.md#currencies)

Diagram currencies

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

**Registration** : To access the production environment register 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 in NA (North America), LAC (Latin America), MEA (Middle East and Africa), Europe \[Excluding EEA\] and AP (Asia Pacific) regions. For issuers in European Economic Area (EEA), see [Enhanced Currency Conversion Calculator API](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/).

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

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

The Standard 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/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 Standard Currency Converter Calculator refer the following links:

|                                                            Category                                                            |                                           Description                                           |
|--------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| [API Basics](https://developer.mastercard.com/currency-conversion-calculator/documentation/api-basics/index.md)                | Authentication, API environments and keys.                                                      |
| [Use Cases](https://developer.mastercard.com/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/currency-conversion-calculator/documentation/tutorials-guides/index.md) | Tutorials \& Guides for easy integration.                                                       |
| [API Reference](https://developer.mastercard.com/currency-conversion-calculator/documentation/api-reference/index.md)          | Try the Sandbox APIs directly from your browser.                                                |
| [Reference Application](https://developer.mastercard.com/currency-conversion-calculator/documentation/reference-app/index.md)  | Reference Application that can be downloaded.                                                   |
| [Parameters](https://developer.mastercard.com/currency-conversion-calculator/documentation/parameters/index.md)                | Requests and responses for each endpoint.                                                       |
| [Code and Formats](https://developer.mastercard.com/currency-conversion-calculator/documentation/code-and-formats/index.md)    | Error codes and the formats Mastercard uses.                                                    |
| [Support](https://developer.mastercard.com/currency-conversion-calculator/documentation/support/index.md)                      | FAQs and support.                                                                               |