Skip to main content
Balance accounts on Busha are designed to hold specific currencies, making them a crucial component for managing your multi-currency transactions. This guide will walk you through the process of programmatically creating new balance accounts and retrieving existing ones via the Busha API.
What You’ll Achieve:
  1. Learn how to create a new balance account for a specific currency
  2. Understand how to retrieve a list of all your existing balance accounts
  3. Confirm successful API interactions for managing currency balances

​
Prerequisites

Before you begin, ensure you have:

​
Managing Your Balance Accounts

1

Identify Supported Currencies

Before creating a balance account, you must know which currencies Busha currently supports. This ensures your requests are valid.To find supported currencies:
  • Refer to the Supported Currencies Reference for the most up-to-date list of available currency codes.
  • When presenting a currency options to your customers, ensure you only display those returned by Busha’s API or listed in our documentation to prevent invalid requests.
2

Retrieve All Your Balance Accounts

To view a comprehensive list of all existing balance accounts associated with your business, use a GET request. This is useful for displaying current balances or iterating through available currencies.To retrieve balance accounts:
  1. Open your terminal or command prompt
  2. Use the GET request below, replacing the placeholders:
    • YOUR_BASE_URL: Use your chosen environment’s base URL.
    • {YOUR_SECRET_API_KEY}: Your actual Secret API Key.
Expected ResponseA successful response will return a JSON object containing an array of all your balance accounts.

​
Troubleshooting

  • 401 Unauthorized Request: Double-check your API key.

​
What’s Next?

Now that you know how to retrieve balance accounts, you can: