The Conversion Rate object (FX)
Description
The Conversion Rate object represents a foreign exchange rate offered by Mangopay for a currency pair.
Note – Activation required
Foreign exchange requires activation for your API environment, even in Sandbox. In Production, the feature is subject to a contract amendment. For more information or to activate contact the Support team via the Hub.
Attributes
Returned values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The sell currency (the currency of the debited wallet during a conversion).
Returned values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The buy currency (the currency of the credited wallet during a conversion).
Max. 7 decimal places
The rate including Mangopay’s markup, indicative of the rate invoiced during the billing cycle: ClientRate
= MarketRate
* (1 - markup).
The ClientRate
fluctuates in line with the MarketRate
.
Max. 7 decimal places
The rate used to convert funds during a conversion: (DebitedFunds.Amount
- Fees
) * MarketRate
= CreditedFunds.Amount
.
The market rate fluctuates in line with FX market dynamics and is common to all platforms for the currency pair.
The date and time at which the market rate was retrieved.
Related resources
Guide
Was this page helpful?