The Quote object (Guaranteed FX)
The Quote object (Guaranteed FX)
Description
The Quote object represents an agreement to freeze a conversion rate, for a given currency pair, for a duration of time.
Before it expires, an active quote can be used to create a quoted conversion at the quoted rate:
- Between user wallets, using POST Create a Quoted Conversion between user Wallets
- Between client wallets, using POST Create a Quoted Conversion between Client Wallets
A quote is not required to create an instant conversion.
Attributes
Max length: 128 characters (see data formats for details)
The unique identifier of the object.
Unix timestamp (UTC) of the date and time the object was created.
Unix timestamp (UTC) of the date and time 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 theExpirationDateis passed.
Information about the fees taken by the platform for this transaction (and hence transferred to the Fees Wallet).
Note: The fees currency must match the debited funds currency.
Information about the MarketRate used to convert funds and other indicative rates.
Information about the Fees sent in the request.
Max. length: 255 characters
Custom data that you can add to this object.
Allowed values: 300, 3600
The time in seconds during which the quote is active and can be used for conversions.
By default, quotes are available for a duration of 5 or 60 minutes, as agreed between Mangopay and the platform.