Skip to main content

Make a Withdrawal

In order to withdraw your funds, you need to send a POST request to the following endpoint:

POST https://www.mimbla.com/api/v1/merchant/withdraw

The request body should contain the following parameters:

ParameterTypeDescriptionRequired
amountnumberThe amount to withdrawYes
cryptostringThe crypto to withdrawYes
addressstringThe address of the crypto you want to withdraw toYes

Request Parameters

  • amount - The amount to be paid in the invoice, in the currency specified by crypto, the amount should be at least 10 USD at the time of the creation of the invoice
  • crypto - The crypto you want to withdraw, can be BTC, BCH, LTC or XMR
  • address - The address of the crypto you want to withdraw to, make sure that the address is valid and belongs to the crypto you specified, otherwise the request will fail with an error message.

Note: The minimum amount that is allowed to be withdrawn is 10, you must specify the amount in crypto, internally we will convert it to USD and check if the amount is at least 10 USD, if you use a cryptocurrency as the crypto parameter, the amount will be converted to USD and the minimum amount will be calculated based on the current exchange rate, so if you choose BTC and set the amount to something like 0.0000001 BTC and if that is less than 10 USD at the time of the creation of the invoice, the request will fail with an error message.

Example Request

POST https://www.mimbla.com/api/v1/merchant/withdraw
Content-Type: application/json

{
"amount": 0.01,
"crypto": "BTC",
"address": "bc1qxyz1234567890abcdefg1234567890abcdefg"
}

Example Successful Response

If your request is successful, you will receive a response with the http status code 201 Created and the following body:

{
"id": "299",
"status": "pending",
}

Once you get a "pending" status it means your withdrawal order was accepted by our system and the withdrawal order has been put in queue, you should expect your payment to arrive soon, you can check the status of the withdrawal by using the Get Withdrawal Status endpoint by using the provided withdrawal request returned ID (299 in the previous example), which will return the current status of the withdrawal and if it has been completed or not.

Example Error Response

If your request is unsuccessful, you will receive a response with the http status code 400 Bad Request and the following body:

{
"message": "<error message>",
"status": "error",
}