Setup Sandbox Environment • Busha Developer Documentation

You’ve successfully made your first request to Busha! Now, it’s time to unleash your development creativity in the Busha Sandbox environment fully. This dedicated testing ground allows you to build, test, and iterate on your integrations without affecting live data or incurring real costs.

What You’ll Achieve:

Understand the purpose and benefits of the Sandbox.
Learn how to configure your requests for the Sandbox.
Explore and test various Busha API endpoints in a safe space.

Why Use the Sandbox?

The Sandbox environment is your essential playground for:

Risk-Free Testing: Experiment with different API calls, edge cases, and error handling without impacting real users or funds.
Rapid Iteration: Develop and debug your application’s integration quickly and efficiently.
Feature Exploration: Explore Busha before going live.
Simulated Scenarios: Mimic various user flows and transaction outcomes (e.g., successful deposits, failed payouts, specific error codes).

Create Your Sandbox Account FirstBefore you begin, you need a Busha Sandbox account to get your API keys.Create a sandbox account: https://sandbox.dash.busha.io/business/signupFollow the same signup steps from the Quick Start guide. Sandbox personal accounts require 2FA, and business accounts are automatically verified.Please note that you still need to go through the KYB submission flow first, you can use dummy data and documents for this, it only takes about 5 minutes.

How to Setup your Sandbox

Connect to the Sandbox Environment

The primary difference between the Sandbox and the Production environment is the base URL used for API requests.To connect to the Sandbox: Ensure your API calls target the following base URL:https://api.sandbox.busha.so

ExampleIf your first request to production was https://api.busha.co/v1/accounts, the equivalent Sandbox request would be https://api.sandbox.busha.so/v1/accounts.

Generate Your API Keys

The API key you generated in the Quick Start Guide is valid for the Sandbox environment.To use your API keys in the Sandbox environment, continue to use your Authorization: Bearer {your_secret_api_key} header with the Secret API Key you obtained previously for all Sandbox requests.

Explore and Test Endpoints

With your environment configured, you can now start sending various requests to the Sandbox API. Think about the features you want to integrate into your application and try making the corresponding API calls.Let’s retrieve our Sandbox account balances:

    $ curl -X GET "https://api.sandbox.busha.so/v1/balances" \
      -H "Authorization: Bearer {YOUR_SECRET_API_KEY}" \
      -H "Content-Type: application/json"

Expected Response:

{
  "status": "success",
  "message": "message for success",
  "pagination": {
    "next_cursor": "MjAyNC0xMC0xNVQxMTowNTo1My45NTkxNDErMDE6MDA=",
    "current_entries_size": 20,
    "previous_cursor": "MjAyNC0xMC0xNVQxMDowNTo1My45NTIxQjE3MDE6MDA="
  },
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "platform_123456",
      "profile_id": "platform_123456",
      "currency": "BTC",
      "name": "Bitcoin",
      "type": "crypto",
      "pending": {
        "amount": "100",
        "currency": "BTC",
        "fiat": {
          "amount": "100",
          "currency": "BTC"
        }
      },
      "available": {
        "amount": "100",
        "currency": "BTC",
        "fiat": {
          "amount": "100",
          "currency": "BTC"
        }
      },
      "savings": {
        "amount": "100",
        "currency": "BTC",
        "fiat": {
          "amount": "100",
          "currency": "BTC"
        }
      },
      "investments": {
        "amount": "100",
        "currency": "BTC",
        "fiat": {
          "amount": "100",
          "currency": "BTC"
        }
      },
      "total": {
        "amount": "100",
        "currency": "BTC",
        "fiat": {
          "amount": "100",
          "currency": "BTC"
        }
      }
    }
  ]
}

Funding Your Sandbox Account

Before you can test transfers, quotes, or payouts, your sandbox account needs a balance. Since Sandbox doesn’t move real money, you can simulate a fiat deposit directly from the dashboard in a few clicks.

Open the Deposit menu

View screenshot

Once you’ve completed KYB and your business account is verified, go to your Sandbox dashboard. To fund your sandbox account with fiat, you can simulate a deposit by clicking on the deposit icon.

Select 'Deposit cash'

View screenshot

From the dropdown, click on Deposit cash.

Deposit dropdown with Deposit cash highlighted

Select your currency

View screenshot

Select your preferred currency.

Enter an amount

View screenshot

Enter an amount and continue.

Confirm the simulated transfer

View screenshot

You’ll be directed to the details screen. Click I have made the transfer, and your account will be credited.

Transfer details screen with confirmation button highlighted

You can now convert these funds to other fiat currencies or crypto via the API or the dashboard for your testing.

Important Sandbox Notes & Limitations

No Real Funds: All transactions performed in the Sandbox are simulated. No actual money will move, and your real balances remain unaffected.
Test Data: The Sandbox may contain predefined test accounts or mock data. Do not expect it to reflect your live production balances.
Rate Limits: While generally more lenient than production, observe fair usage. Excessive requests might still be rate-limited.
Feature Parity: The Sandbox aims for high feature parity with production, but some advanced or newly released features might not be immediately available or behave slightly differently. Always check the API reference for specific endpoint statuses.
Error Simulation: The Sandbox is excellent for testing error handling. You can often trigger specific error responses by using certain invalid inputs. Consult the Error Handling Reference for details on how to simulate common errors for robust error handling in your application.

What’s Next?

Once you’re confident with your integration in the sandbox and your application is performing as expected, you’ll be ready to transition to the live Production Environment.

Start Here

Accept Payments (API)

Accept Payments (SDK & Widgets)

On/Off Ramp (API)

Customer Onboarding (B2B2C)

Balance & Treasury

Recipients

Token Sharing

Request ID

OAuth2

Pledges

Webhooks

Reference

Setting up a Sandbox

Why Use the Sandbox?

How to Setup your Sandbox

Funding Your Sandbox Account

Important Sandbox Notes & Limitations

What’s Next?

​Why Use the Sandbox?

​How to Setup your Sandbox

​Funding Your Sandbox Account

​Important Sandbox Notes & Limitations

​What’s Next?

Why Use the Sandbox?

How to Setup your Sandbox

Funding Your Sandbox Account

Important Sandbox Notes & Limitations

What’s Next?