# Tutorials & Guides
source: https://developer.mastercard.com/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, and then you can begin accessing documentation and creating projects. To assist, 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 **Standard Currency Conversion Calculator** when creating your project.

### Create a Sandbox Project {#create-a-sandbox-project}

Refer [How to Create a Project tutorial](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-create-a-project/index.md) to create a new project and generate the keys required for the Sandbox environment.

### 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/currency-conversion-calculator/documentation/api-reference/index.md), to generate an API client. When used with the provided [client authentication libraries](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 Standard Currency Conversion Calculator API to Production {#promote-standard-currency-conversion-calculator-api-to-production}

Refer [How to Move to Production tutorial](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-move-to-production/index.md) to move your project to production from the sandbox environment.  

### How to Integrate using Reference Application {#how-to-integrate-using-reference-application}

Refer [How to Integrate using Reference Application](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/index.md) to integrate using reference application.

### Endpoint Tutorials {#endpoint-tutorials}

Endpoints are specific URLs or URIs (Uniform Resource Identifiers) that represents resources or services. Each endpoint corresponds to a specific function or operation that Standard Currency Conversion Calculator API can perform. When you make a request to a particular endpoint, you are instructing the API to carry out a specific action or retrieve specific information.

#### Tutorials of available API Calls {#tutorials-of-available-api-calls}

|                                                                                            Endpoint                                                                                            |                                                                                                       Description                                                                                                        |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Conversion Rate](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/howitworks/index.md#conversion-rate)               | Provides transaction details including date, transaction currency and amount, cardholder billing currency, and issuer specific markup to determine the applicable currency conversion rate and cardholder billing amount |
| [Currencies](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/howitworks/index.md#currencies)                         | Provides a list of currencies for which Mastercard publishes currency conversion rates                                                                                                                                   |
| [Conversion Rate Issued](https://developer.mastercard.com/currency-conversion-calculator/tutorial/how-to-integrate-using-the-reference-application/howitworks/index.md#conversion-rate-issued) | Provides status update if the current day Mastercard currency conversion rates are issued. Mastercard rates are published daily and are effective for 24 hours.                                                          |

## Guides {#guides}

### Currency Conversion Rates guide {#currency-conversion-rates-guide}

The Standard Currency Conversion Calculator provides access to daily 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.   

<br />

* 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 given date, provide the applicable date in the `fxDate` parameter. For example, if today is 20 August 2023, provide a 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).

<br />

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://techdocs.mastercard.com/bundle/BM/page/eyf1624751947844.html)                                                 | Mastercard rules and standards |
| [Authorization Manual](https://techdocs.mastercard.com/bundle/m_AP/page/r_SmryChngs_AP_Aug2020_1.html)                                   | Mastercard core manuals        |
| [Global Clearing Management System Reference Manual](https://techdocs.mastercard.com/bundle/dai1627324065087/page/yxs1623791859792.html) | Mastercard core manuals        |