Overview
User management
- Users
- User regulatory status
- User e-money
User verification
- User data format
- KYC documents
- UBO declarations
Wallets
- User wallets
- Client wallets
Cards
- Card registrations
- Cards
- Metadata
- Card validations
Card pay-ins
- Direct card pay-ins
- Recurring card pay-ins
- Preauthorizations
- Deposit preauthorizations
- Web card pay-ins
Banking pay-ins
- Bank wires
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- BLIK
- Giropay
- Google Pay
- iDEAL
- Klarna
- MB WAY
- Multibanco
- Payconiq
- PayPal
- Satispay
Transfers
- Transfers
Refunds
- Refunds
Disputes
- Disputes
- Dispute documents
- Repudiations
- Dispute settlement
Payouts
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
Create a Quote
This call guarantees a conversion rate to let you Create a Quoted Conversion.
Body parameters
Information about the debited funds.
Allowed values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the debited funds (the sell currency).
Required if CreditedFunds
Amount
is null
An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as 1260
whereas JPY 12 would be represented as just 12
).
During a conversion, DebitedFunds
Amount
* MarketRate
= CreditedFunds
Amount
.
Information about the credited funds.
Allowed values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the credited funds (the buy currency).
Required if CreditedFunds
Amount
is null
An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as 1260
whereas JPY 12 would be represented as just 12
).
During a conversion, DebitedFunds
Amount
* MarketRate
= CreditedFunds
Amount
.
Information about the fees taken by the platform for this transaction (and hence transferred to the Fees Wallet).
Note: For conversions between client wallets, the quote cannot have Fees
specified.
Allowed values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
Required if Fees
is sent.
The currency of the fees.
Required if Fees
is sent.
An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as 1260
whereas JPY 12 would be represented as just 12
).
Max. length: 255 characters
Custom data that you can add to this object.
For transactions (pay-in, transfer, payout), you can use this parameter to identify corresponding information regarding the user, transaction, or payment methods on your platform.
The time in seconds during which the quote is active and can be used for conversions.
Responses
The unique identifier of the object.
The date and time at which the object was created.
The date and time at which the quote expires and can no longer be used.
Returned values: ACTIVE
, EXPIRED
The status of the quote:
ACTIVE
– The quote can be used to execute a quoted conversion.EXPIRED
– The quote can’t be used because theExpirationDate
is passed.
Information about the debited funds.
Returned values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the debited funds (the sell currency).
An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as 1260
whereas JPY 12 would be represented as just 12
).
During a conversion, DebitedFunds
Amount
* MarketRate
= CreditedFunds
Amount
.
Information about the credited funds.
Returned values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the credited funds (the buy currency).
An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as 1260
whereas JPY 12 would be represented as just 12
).
During a conversion, CreditedFunds
Amount
= DebitedFunds
Amount
* MarketRate
.
Information about the conversion rate used during the transaction.
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
* MarketRate
= CreditedFunds
Amount
.
The market rate fluctuates in line with FX market dynamics and is common to all platforms for the currency pair.
Max. length: 255 characters
Custom data that you can add to this object.
For transactions (pay-in, transfer, payout), you can use this parameter to identify corresponding information regarding the user, transaction, or payment methods on your platform.
{
"Message": "Duration 300 is not in the allowed list: 90",
"Type": "forbidden_ressource",
"Id": "3af49cbd-d68c-403c-8a37-b1ef40c224a6",
"Date": 1707299786,
"errors": null
}
{
"Message": "The currency JPY is not enabled for Forex. Contact your support to activate this feature.",
"Type": "forbidden_ressource",
"Id": "0dbb7cbc-da22-4b67-8685-b1aea8c4551e",
"Date": 1707315388,
"errors": null
}
{
"Message": "Quoted conversion is not enabled. Contact your support to activate this feature.",
"Type": "forbidden_ressource",
"Id": "cb1a7c79-4ece-4930-9996-9c43b35df3b7",
"Date": 1707315678,
"errors": null
}
{
"Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
"Type": "param_error",
"Id": "c1407e47-9146-486d-81b0-54cf9142f2c3",
"Date": 1720793416.0,
"errors": {
"Quote.Amount": "Debited amount or credited amount is required"
}
}
{
"Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
"Type": "param_error",
"Id": "bd657a7e-7250-4d35-a49b-eddd24126e7b",
"Date": 1720793433.0,
"errors": {
"Quote.Amount": "Only one of these fields is required: debited amount or credited amount"
}
}
Was this page helpful?