Skip to main content

Sandbox Environment​

Mimbla provides a sandbox environment for you to test your integration before going live. The sandbox environment allows you to test your integration with Mimbla without using real funds. It is a safe and secure environment where you can experiment with different features and functionalities of the Mimbla API.

Accessing the Sandbox Environment​

To access the sandbox environment, you need to use the following URL:

  • API Base URL: https://www.mimbla.com/api/v1

This is the base URL for all API requests in the sandbox environment. You can use this URL to test all the API endpoints available in the Mimbla API documentation.

Testnet Coins​

The sandbox environment uses testnet coins, which are cryptocurrencies that are used for testing purposes. Testnet coins have no real value and can be obtained for free from testnet faucets.

Here are some testnet faucets where you can get testnet coins:

Using the Sandbox Environment​

To use the sandbox environment, you need to replace the production URLs with the sandbox URLs in your integration code. For example, if you are using the production API base URL https://www.mimbla.com/api/v1, you need to replace it with the sandbox API base URL https://www.mimbla.com/api/v1.

Here is an example of how you can use the sandbox environment to create an invoice:

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

{
  "amount": "10",
  "crypto": "LTC",
}

In this example, we are using the sandbox API base URL https://www.mimbla.com/api/v1 to create an invoice with an amount of 10 LTC.

How to use the test / sandbox environment​

In order to test the sandbox environment you need to login into your business account, and press "Testnet mode" in the drop down menu in the top right corner of the page, then go to your businesses and create a new test business, this business will be created in the testnet mode, and you will be able to test all the features of the Mimbla API in the sandbox environment.

Download

Things to Keep in Mind​

  • The sandbox environment is for testing purposes only and doesn't require any real funds.
  • The sandbox environment may have some limitations compared to the production environment, such as limited rate and the inability to withdraw funds in the testnet wallet.
  • The sandbox environment is exactly the same as the production environment, so you can test all the features and functionalities of the Mimbla API, including creating invoices, checking payment status, and managing your account.
  • The sandbox environment is reset periodically, so any test data you create may be deleted after a certain period of time.
  • The sandbox environment is not intended for production use, and you should not use it for any real transactions or sensitive data.

Dedicated Sandbox Environment​

We offer a dedicated sandbox environment for our enterprise customers. The dedicated sandbox environment provides a separate environment for each enterprise customer, allowing them to test their integration in isolation and gives them more control over the environment. On top of that the dedicated sandbox environment uses regtest coins, which are cryptocurrencies that are used for testing purposes and can be generated on demand by the customer so they don't have to rely on external faucets.