POST
/
v2.01
/
{ClientId}
/
conversions
/
quoted-conversion
{
    "QuoteId": "cvrquote_01HP1H6EK4H39SCQ8WJ349WMBB",
    "AuthorId": "204071581",
    "DebitedWalletId": "204079338",
    "CreditedWalletId": "209408867",
    "Tag": "Created using the Mangopay API Postman collection"
}  

{
    "Id": "cvr_01J3G1FKHQ5NAPM2ZG8RKKD706",
    "QuoteId": "cvrquote_01J3G1FBKHNSB88AJ7RDRCFK9S",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1721746574,
    "Status": "SUCCEEDED",
    "AuthorId": "user_m_01HSB23417BFG7YXR7E371JSEA",
    "DebitedWalletId": "wlt_m_01HSJTVB0JKMMHXBEJBV6TMF96",
    "CreditedWalletId": "wlt_m_01J3G1CY4VH5FNMSAM8M0S5A64",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 1000
    },
    "CreditedFunds": {
        "Currency": "USD",
        "Amount": 1162
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 100
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1721746575,
    "ConversionRateResponse": {
        "ClientRate": 1.2787055,
        "MarketRate": 1.2911001
    },
    "Tag": "Created using the Mangopay API Postman collection"
}
This call triggers a conversion at the rate defined in its quote. The debited funds (buy currency), credited funds (sell currency) and currencies are defined in the quote. Each quoted conversion requires a dedicated Quote object, linked in the QuoteId.

​
Body parameters

​
QuoteId
string
required
The unique identifier of the active quote which guaranteed the rate for the conversion.
​
AuthorId
string
required
The unique identifier of the user at the source of the transaction. In a conversion, both the debited and credited wallets are owned by the author.
​
DebitedWalletId
string
required
The unique identifier of the debited wallet (in the sell currency).
​
CreditedWalletId
string
required
The unique identifier of the credited wallet (in the buy currency).
​
Tag
string
Max. length: 255 charactersCustom 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.

​
Responses

Functional errors (ResultCode) are possible on a 200 response. Read more → 
{
    "Id": "cvr_01J3G1FKHQ5NAPM2ZG8RKKD706",
    "QuoteId": "cvrquote_01J3G1FBKHNSB88AJ7RDRCFK9S",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1721746574,
    "Status": "SUCCEEDED",
    "AuthorId": "user_m_01HSB23417BFG7YXR7E371JSEA",
    "DebitedWalletId": "wlt_m_01HSJTVB0JKMMHXBEJBV6TMF96",
    "CreditedWalletId": "wlt_m_01J3G1CY4VH5FNMSAM8M0S5A64",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 1000
    },
    "CreditedFunds": {
        "Currency": "USD",
        "Amount": 1162
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 100
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1721746575,
    "ConversionRateResponse": {
        "ClientRate": 1.2787055,
        "MarketRate": 1.2911001
    },
    "Tag": "Created using the Mangopay API Postman collection"
}

{
    "QuoteId": "cvrquote_01HP1H6EK4H39SCQ8WJ349WMBB",
    "AuthorId": "204071581",
    "DebitedWalletId": "204079338",
    "CreditedWalletId": "209408867",
    "Tag": "Created using the Mangopay API Postman collection"
}