Skip to main content
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. For conversions between Client Wallets, the Fees cannot be specified.

​
Body parameters

​
DebitedWalletType
string
required
Allowed values: FEES, CREDITThe 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, CREDITThe 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 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.
​
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.
​
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.
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"
}