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:
Parameter | Type | Description | Required |
---|---|---|---|
amount | number | The amount to withdraw | Yes |
crypto | string | The crypto to withdraw | Yes |
address | string | The address of the crypto you want to withdraw to | Yes |
Request Parameters
amount
- The amount to be paid in the invoice, in the currency specified bycrypto
, the amount should be at least 10 USD at the time of the creation of the invoicecrypto
- The crypto you want to withdraw, can beBTC
,BCH
,LTC
orXMR
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",
}