# Support source: https://developer.mastercard.com/payment-currency-conversion/documentation/support/index.md ## FAQs {#faqs} ### General {#general} This service assists Originating Institutions with cross-border payment transactions by enabling them to get the current currency conversion rates and calculated settlement amounts before they initiate those transactions. This service is for use by Mastercard Send Originating Institutions or Mastercard Merchant Presented QR (MPQR) Originating Institutions approved for cross-border transactions. No. This API returns conversion details relevant to settlement of Mastercard Send and MPQR transactions. It does not give general cardholder currency conversion rates. For those rates, please use alternative conversion services, such as the [Standard or Enhanced Currency Conversion Calculator](https://developer.mastercard.com/product/currency-conversion-calculator). Mastercard publishes currency conversion rates once per day and the rates are effective for a 24-hour period. See the [Currency Conversion Rates guide](https://developer.mastercard.com/payment-currency-conversion/documentation/tutorials-and-guides/index.md#currency-conversion-rates-guide). ### Onboarding {#onboarding} See [Guides](https://developer.mastercard.com/payment-currency-conversion/documentation/tutorials-and-guides/index.md). This service is for use by Mastercard Send Originating Institutions or MPQR Originating Institutions approved for cross-border transactions. To initiate onboarding to Mastercard Send or MPQR, contact your regional Mastercard representative. If you do not have one, please use the **Contact sales** button and form on the [Mastercard Developers page](https://developer.mastercard.com/) to request a regional representative, identifying your company name, region, and the Mastercard program (Mastercard Send or MPQR) and services that interest you. To use the full Production service, you must be registered as either: * A Mastercard Send Originating Institution approved for cross-border transactions * An MPQR Originating Institution approved for cross-border transactions No additional registration forms are required to use this API service. Contact your Mastercard representative for more information. Currently, use of this API is free of charge. ### Integration {#integration} Yes, the Sandbox APIs are provided so that you can try the APIs quickly. They are API stubs that return simulated responses. Due to the simplicity of this API service, you also use the Sandbox APIs for your pre-production testing and validation. When you are ready to make API calls to the Sandbox server from an API tool or your application, you must create a Mastercard Developers project choosing the **Currency Conversion for Originating Institution** API service, generate the Sandbox Keys, and use the keys to generate OAuth 1.0a Authorization Headers for your API requests. See [API Basics](https://developer.mastercard.com/payment-currency-conversion/documentation/api-basics/index.md). To start using the Sandbox APIs, create a Mastercard Developers project choosing the **Currency Conversion for Originating Institution** API service, and download the Sandbox Key. The APIs use OAuth 1.0 authentication, so your API requests must have an OAuth 1.0a Authorization Header, generated using the Sandbox keys. See [API Basics](https://developer.mastercard.com/payment-currency-conversion/documentation/api-basics/index.md). Due to the simplicity of this API service, you use the Sandbox APIs for your pre-production testing and validation. For test data, see [Testing](https://developer.mastercard.com/payment-currency-conversion/documentation/testing/index.md). No, there are no Mastercard Test Facility (MTF) APIs for this service. You use the Sandbox APIs for your pre-production testing and validation. For error codes, meanings, and resolutions, see [Error Codes (Reason Codes)](https://developer.mastercard.com/payment-currency-conversion/documentation/code-and-formats/index.md#error-codes-reason-codes). This happens when your [Conversion Rate Details](https://developer.mastercard.com/payment-currency-conversion/documentation/api-reference/index.md#tag/Conversion-Rate-Details) API request (`/transaction-settlement-rate-details` endpoint) was made before the new conversion rates are published, so the previous day's conversion rate is still effective, as reflected by the date in the `conversionRateDate` field. You might not be using the current date in your [Conversion Rate Details](https://developer.mastercard.com/payment-currency-conversion/documentation/api-reference/index.md#tag/Conversion-Rate-Details) API request (`/transaction-settlement-rate-details` endpoint): `transaction_date` path query parameter. Please use the current date. For error codes, meanings, and resolutions, see [Error Codes (Reason Codes)](https://developer.mastercard.com/payment-currency-conversion/documentation/code-and-formats/index.md#error-codes-reason-codes). You must: * Be a Mastercard Send or MPQR Program Participant. * Complete your testing with the Sandbox APIs. * Request Production access for your project (by clicking **Request Production Access** in your project page) and receive approval from Mastercard. * Provide your Production Consumer Key to your Mastercard Implementation Manager (if you have an active Mastercard Send or MPQR implementation project with the CIS team) or Mastercard representative so they can get the Mastercard SAM Application Support team to configure the environment for your keys. When you request Production access for your project (by clicking **Request Production Access** in your project page), it requires approval and configuration by Mastercard, which can take 5-7 business days. See [Good to Know](https://developer.mastercard.com/payment-currency-conversion/documentation/index.md#good-to-know). The Production Key and Consumer Key (used for authentication) are different from the Sandbox keys. The Production API endpoints are also different. All API responses include a Correlation ID (`correlation-id`) header value, which is a unique ID for each API call in Mastercard systems. We recommend you log this ID for tracking purposes. When seeking support, providing the relevant Correlation ID may help resolve your inquiry more quickly. ### Policy {#policy} The APIs support Transport Layer Security (TLS) 1.2 and 1.3, and use OAuth 1.0a for authentication, see [API Basics](https://developer.mastercard.com/payment-currency-conversion/documentation/api-basics/index.md). The APIs do not use additional encryption. Your API GET requests do not have body payloads. Yes, all of our APIs are PCI compliant. ### Performance {#performance} Throttling is not implemented for this API. This varies over time. We have seen an average of approximately 35 TPS. For production, testing indicates an average of less than 20 milliseconds per response, measured at the Mastercard API gateway. ### Support {#support} When you contact Mastercard and request access to this service, you are typically connected with a regional Mastercard representative who can provide further information about the Mastercard Send/MPQR program and guide you through Mastercard Send/MPQR registration and eligibility requirements. When you are ready for program implementation, you will be assigned a Mastercard Delivery Manager who will guide you through implementation. If you have not been connected with a Mastercard representative, please use the **Contact sales** button and form on the [Mastercard Developers page](https://developer.mastercard.com/) to request a regional representative, identifying your company name, region, and the Mastercard program (Mastercard Send or MPQR) and services that interest you. For technical support, use the **Get Help** button at the bottom of this page. The [API Status](https://developer.mastercard.com/api-status) page informs Mastercard Developers users of the status of each API. Direct links to the status for this service: [Sandbox API](https://developer.mastercard.com/api-status?environment=sandbox&service=Currency%20Conversion%20for%20Originating%20Institution) and [Production API](https://developer.mastercard.com/api-status?environment=production&service=Currency%20Conversion%20for%20Originating%20Institution). ### Legal disclaimer {#legal-disclaimer} The currency conversion rate and the converted amount are indicative only and based on the API request values you submit. Receiving issuers (Receiving Institutions) may or may not use Mastercard currency conversion rates to credit cardholders and may impose additional fees in connection with foreign currency transactions. Currency conversion rates are specific to the date and time the receiving issuer authorizes the transaction (which generally occurs at the point of sale/interaction). If Mastercard is unable to apply the currency conversion rate at authorization, Mastercard will apply the currency conversion rate at the date and time the transaction is processed. If a transaction is converted by the receiving issuer, Mastercard currency conversion rates will not apply. This will usually occur when you initiate a payment transaction in the sending card's currency as opposed to the receiving card's currency. Mastercard, in its sole discretion, may restrict usage of this API as Mastercard may deem necessary or appropriate. ## Get Help {#get-help} ### Contact us for technical support. {#contact-us-for-technical-support}