POST
/
v2.01
/
{ClientId}
/
clients
/
conversions
/
quoted-conversion
{
  "QuoteId" : "cvrquote_01J475ZRENK67V9A62JCQ6PYVW",
  "DebitedWalletType" : "FEES",
  "CreditedWalletType" : "CREDIT",  
  "Tag": "Created using Mangopay API Collection Postman"
}

{
    "Id": "cvr_01J475ZYZ6WBZK3JK3HSZFXHVN",
    "QuoteId": "cvrquote_01J475ZRENK67V9A62JCQ6PYVW",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1722523057,
    "Status": "SUCCEEDED",
    "AuthorId": "your-client-id",
    "DebitedWalletId": "FEES_EUR",
    "CreditedWalletId": "CREDIT_GBP",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 10
    },
    "CreditedFunds": {
        "Currency": "GBP",
        "Amount": 8
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1722523057,
    "ConversionRateResponse": {
        "ClientRate": 0.8352637,
        "MarketRate": 0.84336
    },
    "Tag": "Created using Mangopay API Collection Postman"
}

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. The Client Wallets to debit and credit are defined in the conversion.

Each quoted conversion requires a dedicated Quote object, linked in the QuoteId.

Note - Quote cannot contain fees

For a quoted conversion between client wallets, the quote cannot have fees specified.

​
Body parameters

​
QuoteId
string
required

The unique identifier of the active quote which guaranteed the rate for the conversion.

​
DebitedWalletType
string
required

Allowed values: FEES, CREDIT

The type of the client wallet to be debited:

  • FEES – Fees Wallet, for fees collected by the platform.
  • CREDIT – Repudiation Wallet, for funds related to dispute management.

The amount and currency of the debited funds are defined by the quote.

​
CreditedWalletType
string
required

Allowed values: FEES, CREDIT

The type of the client wallet to be credited:

  • FEES – Fees Wallet, for fees collected by the platform.
  • CREDIT – Repudiation Wallet, for funds related to dispute management.

The amount and currency of the credited funds are defined by the quote.

​
Tag
string

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.

​
Responses

Functional errors (ResultCode) are possible on a 200 response. Read more →

Was this page helpful?