POST
/
v2.01
/
{ClientId}
/
clients
/
conversions
/
instant-conversion
{
    "DebitedWalletType": "FEES",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 5000
    },
    "CreditedWalletType": "FEES",
    "CreditedFunds": {
        "Currency": "USD"
    },
   "Tag": "Created using Mangopay API Collection Postman"
}

{
    "Id": "cvr_01J47619CVSEVWZE480Z245AMB",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1722523100,
    "Status": "SUCCEEDED",
    "AuthorId": "client-id",
    "DebitedWalletId": "FEES_EUR",
    "CreditedWalletId": "FEES_USD",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 5000
    },
    "CreditedFunds": {
        "Currency": "USD",
        "Amount": 5399
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1722523101,
    "ConversionRateResponse": {
        "ClientRate": 1.071231,
        "MarketRate": 1.07987
    },
   "Tag": "Created using Mangopay API Collection Postman"
}

This call triggers an immediate conversion at the market rate, of the debited funds to the credited wallet at the market rate. A quote is not required for an instant conversion.

​
Body parameters

​
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.

​
DebitedFunds
object
required

Information about the debited funds.

​
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.

​
CreditedFunds
object
required

Information about the credited funds.

​
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 →

{
    "Id": "cvr_01J47619CVSEVWZE480Z245AMB",
    "Type": "CONVERSION",
    "Nature": "REGULAR",
    "CreationDate": 1722523100,
    "Status": "SUCCEEDED",
    "AuthorId": "client-id",
    "DebitedWalletId": "FEES_EUR",
    "CreditedWalletId": "FEES_USD",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 5000
    },
    "CreditedFunds": {
        "Currency": "USD",
        "Amount": 5399
    },
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1722523101,
    "ConversionRateResponse": {
        "ClientRate": 1.071231,
        "MarketRate": 1.07987
    },
   "Tag": "Created using Mangopay API Collection Postman"
}

{
    "DebitedWalletType": "FEES",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 5000
    },
    "CreditedWalletType": "FEES",
    "CreditedFunds": {
        "Currency": "USD"
    },
   "Tag": "Created using Mangopay API Collection Postman"
}