Skip to main content
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_01KH3JAVX32DNZ2141BFMERP5V",
    "QuoteId": "cvrquote_01KH3J69K96FXNMQ875PTDJ13A",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1770720161,
    "Status": "SUCCEEDED",
    "AuthorId": "user_m_01KGHXXFF6AQZA68MESVQVY7RA",
    "DebitedWalletId": "wlt_m_01KGSJDM69VNXPKKGH1B3QFVFC",
    "CreditedWalletId": "wlt_m_01KGSJ7GQY0P12EBB6XFAC866C",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 1000
    },
    "CreditedFunds": {
        "Currency": "EUR",
        "Amount": 1067
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 70
    },
    "RequestedFees": {
        "Type": "PERCENTAGE",
        "Value": 700,
        "Currency": "GBP"
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1770720162,
    "ConversionRateResponse": {
        "ClientRate": 1.1360925,
        "MarketRate": 1.1471047,
        "FinalRate": 1.1190511
    },
    "MarginsResponse": {
        "Mangopay": {
            "Type": "PERCENTAGE",
            "Value": 0.96,
            "Amount": 10
        },
        "User": {
            "Type": "PERCENTAGE",
            "Value": 1.5,
            "Amount": 16
        }
    },
    "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

​
Id
string
Max length: 128 characters (see data formats for details)The unique identifier of the object.
​
QuoteId
string
The unique identifier of the active quote which guaranteed the rate for the conversion.Returned null in the case of an instant conversion.
​
Type
string
The type of transaction.
​
Nature
string
Returned values: REGULAR, REPUDIATION, REFUND, SETTLEMENTThe nature of the transaction, providing more information about the context in which the transaction occurred:
  • REGULAR – Relative to most of the transactions (pay-ins, payouts, and transfers) in a usual workflow.
  • REPUDIATION – Automatic withdrawal of funds from the platform’s repudiation wallet as part of the dispute process (when the user has requested a chargeback).
  • REFUND – Reimbursement of a transaction to the user (pay-in refund), to a wallet (transfer refund), or of a payout (payout refund, only initiated by Mangopay).
  • SETTLEMENT – Transfer made to the repudiation wallet by the platform to settle a lost dispute.
​
CreationDate
Unix timestamp
The date and time at which the object was created.
​
Status
string
Returned values: CREATED, SUCCEEDED, FAILEDThe status of the transaction.
​
AuthorId
string
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
The unique identifier of the debited wallet (in the sell currency).
​
CreditedWalletId
string
The unique identifier of the credited wallet (in the buy currency).
​
DebitedFunds
object
Information about the debited funds.
​
CreditedFunds
object
Information about the credited funds.
​
Fees
object
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.
​
RequestedFees
object
Information about the Fees sent in the request.
​
ResultCode
string
The code indicating the result of the operation. This information is mostly used to handle errors or for filtering purposes.
​
ResultMessage
string
The explanation of the result code.
​
ExecutionDate
Unix timestamp
The date and time at which the status changed to SUCCEEDED, indicating that the transaction occurred. The statuses CREATED and FAILED return an ExecutionDate of null.
​
ConversionRateResponse
object
Information about the MarketRate used to convert funds and other indicative rates.
​
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.
Functional errors (ResultCode) are possible on a 200 response. Read more → 
{
    "Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
    "Type": "param_error",
    "Id": "ffaf5ad6-d9f1-47bf-832c-ea5da626037e",
    "Date": 1706192320,
    "errors": {
        "QuoteId": "Quote not found"
    }
}  

{
    "Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
    "Type": "param_error",
    "Id": "31dc86e1-783e-4e34-94d0-4e1891fd74bb",
    "Date": 1707301282,
    "errors": {
        "QuoteId": "The quote is expired"
    }
}  

{
    "Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
    "Type": "param_error",
    "Id": "2b989396-3dc7-4fcf-8a7e-2c6463262633",
    "Date": 1707301113,
    "errors": {
        "QuoteId": "The quote is already consumed"
    }
}  

{
    "Message": "Credited currency incompatibility.",
    "Type": "currency_incompatibility",
    "Id": "47ade3b3-0c5d-4c32-ae11-1cfd23720a11",
    "Date": 1707314958,
    "errors": null
}  

{
    "Message": "Debited currency incompatibility.",
    "Type": "currency_incompatibility",
    "Id": "f83e073e-287d-4781-bbba-87256dad4aa0",
    "Date": 1707315285,
    "errors": null
}  

{
    "Message": "Author 204071581 is not debited wallet 214818911 owner.",
    "Type": "author_is_not_debited_wallet_owner",
    "Id": "c16cb140-0f02-4c5f-a705-9cfdb11fb499",
    "Date": 1708382645.0,
    "errors": null
}  

{
    "Message": "Author 204071581 is not credited wallet 214818911 owner.",
    "Type": "author_is_not_credited_wallet_owner",
    "Id": "5586bf7e-8e33-4e7a-a140-107f7a9e3a26",
    "Date": 1708382704.0,
    "errors": null
}  

{
    "Id": "cvr_01KH3JAVX32DNZ2141BFMERP5V",
    "QuoteId": "cvrquote_01KH3J69K96FXNMQ875PTDJ13A",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1770720161,
    "Status": "SUCCEEDED",
    "AuthorId": "user_m_01KGHXXFF6AQZA68MESVQVY7RA",
    "DebitedWalletId": "wlt_m_01KGSJDM69VNXPKKGH1B3QFVFC",
    "CreditedWalletId": "wlt_m_01KGSJ7GQY0P12EBB6XFAC866C",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 1000
    },
    "CreditedFunds": {
        "Currency": "EUR",
        "Amount": 1067
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 70
    },
    "RequestedFees": {
        "Type": "PERCENTAGE",
        "Value": 700,
        "Currency": "GBP"
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1770720162,
    "ConversionRateResponse": {
        "ClientRate": 1.1360925,
        "MarketRate": 1.1471047,
        "FinalRate": 1.1190511
    },
    "MarginsResponse": {
        "Mangopay": {
            "Type": "PERCENTAGE",
            "Value": 0.96,
            "Amount": 10
        },
        "User": {
            "Type": "PERCENTAGE",
            "Value": 1.5,
            "Amount": 16
        }
    },
    "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"
}