# Tutorials & Guides source: https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/tutorials-guides/index.md ## Tutorials {#tutorials} ### Account \& Project Creation {#account--project-creation} Here we have provided you with the information needed to create a new API Project and move from the Sandbox environment to Production. Getting started on Mastercard developers is easy. You just need an account, then you can begin accessing documentation, and creating projects. We have provided a [quick start guide](https://developer.mastercard.com/platform/documentation/getting-started-with-mastercard-apis/quick-start-guide/). Make sure that you select **Enhanced Currency Conversion Calculator** when creating your project. ### Create a Sandbox Project {#create-a-sandbox-project} Refer to [How to Create a Project](https://developer.mastercard.com/enhanced-currency-conversion-calculator/tutorial/how-to-create-a-project/index.md) ### Generating a Mastercard API Client {#generating-a-mastercard-api-client} You can use open source tools, such as the [OpenAPI Generator](https://openapi-generator.tech), in conjunction with the provided [API Reference](https://developer.mastercard.com/enhanced-currency-conversion-calculator/documentation/api-reference/index.md), to generate an API client. When used with the provided [client authentication libaries](https://developer.mastercard.com/platform/documentation/security-and-authentication/using-oauth-1a-to-access-mastercard-apis/), and if applicable, [client encryption libaries](https://developer.mastercard.com/platform/documentation/security-and-authentication/securing-sensitive-data-using-payload-encryption/#client-libraries), this is an agile and powerful way to get started with real code to access the service. We have provided a tutorial that walks you through how to generate a Mastercard API client that includes integrating with our provided libraries. For the step-by-step tutorial, refer to [Generating and Configuring a Mastercard API Client](https://developer.mastercard.com/platform/documentation/security-and-authentication/generating-and-configuring-a-mastercard-api-client/). ### Promote Enhanced Currency Conversion Calculator API to Production {#promote-enhanced-currency-conversion-calculator-api-to-production} Refer to [How to Move to Production](https://developer.mastercard.com/enhanced-currency-conversion-calculator/tutorial/how-to-move-to-production/index.md) ### How to Integrate using Reference Application {#how-to-integrate-using-reference-application} Refer to [How to Integrate using Reference Application](https://developer.mastercard.com/enhanced-currency-conversion-calculator/tutorial/how-to-integrate-using-reference-application/index.md) ## Guides {#guides} ### Quick Start guide {#quick-start-guide} Getting started on Mastercard developers is easy. You just need an account, then you can begin accessing documentation, and creating projects. We have provided a [quick start guide](https://developer.mastercard.com/platform/documentation/getting-started-with-mastercard-apis/quick-start-guide/) for you to follow. While following the guide, ensure that you select **Enhanced Currency Conversion Calculator API** when creating your project. ### Currency Conversion Rates guide {#currency-conversion-rates-guide} The Enhanced Currency Conversion Calculator provides access to Mastercard currency conversion rates and European Central Bank (ECB) reference rates. #### Mastercard Currency Conversion Rates {#mastercard-currency-conversion-rates} Mastercard publishes currency conversion rates once per day and the rates are effective for a 24-hour period. Mastercard foreign exchange rates are specific to the date and time the bank authorizes the transaction (which generally occurs at the point of sale/interaction). For certain transactions, including those submitted to Mastercard for processing nine or more days from the original date of authorization, Mastercard will apply the foreign exchange rate in effect at the date and time Mastercard processes the transaction.
* To retrieve currency conversion rates effective at the time of the request, provide 0000-00-00 in the `fxDate` parameter. * To retrieve the currency conversion rates for a give date, provide the applicable date in the `fxDate` parameter. For example, if today is 20 August 2023, provide date as 2023-08-20. * For more information about Mastercard currency conversion rates, refer to the core manuals available on [Mastercard Connect](https://www.mastercardconnect.com/mccpblcui/#/public/signin)\> [Technical Resource Center](https://techdocs.mastercard.com/category/references). Tip: You can use **Mastercard-currencies** API service for a list of available currencies and **Conversion-rate-issued** API service to determine if rates are published for the given date . #### European Central Bank (ECB) reference rates {#european-central-bank-ecb-reference-rates} The API supports all reference rates currently published by the [European Central Bank](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html) (ECB). * The API is usually updated within one hour after the new ECB reference rates are published by the European Central Bank at 16:00 Central European Time. * If ECB reference rates are not published by the European Central Bank for a given date, the API will display the last published rate. * For more information, refer to the [ECB website](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html). Tip: You can use **ECB-currencies** API service for a list of available currencies and **Conversion-rate-issued** API service to determine if rates are published for the given date . Further information can be found in the below documents, which are available on [Mastercard Connect](https://www.mastercardconnect.com/mccpblcui/#/public/signin)\> [Technical Resource Center](https://techdocs.mastercard.com/category/references). | Document | Description | |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [Mastercard Rules](https://trc-techresource.mastercard.com/r/bundle/m_mcrs_en-us/page/d/en-US/hrc1744216454865.html) | Mastercard rules and standards | | [Authorization Manual](https://trc-techresource.mastercard.com/r/bundle/m_AP_en-us/page/d/en-US/osq1748371604832.html) | Mastercard core manuals | | [Global Clearing Management System Reference Manual](https://trc-techresource.mastercard.com/r/bundle/m_gcmsrefmanual_en-us/page/d/en-US) | Mastercard core manuals | | [AN 3493 Enhanced Currency Conversion API and Pricing for Issuers in the EEA Countries](https://techdocs.mastercard.com/announcements?labelkey=type_announce&labelkey=type_bulletin_announce&sort.field=last_revised&sort.value=dec) | Pricing \& billing information |