Balance Accounts

Balance accounts represent distinct accounts for a specific currency

Creating and Managing Balance AccountsCopied!

Balance accounts are designed to handle specific currencies, making them a crucial part of managing multi-currency transactions.

To create a balance account, you must first retrieve the most up-to-date list of supported currencies on Busha. For more information, refer to the Currency Section.

Once you’ve identified the desired currency, allow your customers to select their preferred option. Use the corresponding currency code to create a new balance account via the Busha API.

1. Creating a Balance Account

To create a balance account, use the following POST request:

curl --request POST \
  --url https://api.busha.co/balances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "currency": "btc"
}'

Replace <token> with your valid API authorization token.
Replace "btc" with the selected currency code (e.g., "usd", "ngn", etc.).

2. Retrieving Balance Accounts

To view all existing balance accounts, use the GET request below:

curl --request GET \
  --url https://api.busha.co/balances \
  --header 'Authorization: Bearer <token>'

This request returns a list of all balance accounts associated with your business.

Additional Notes

Ensure that customers are presented with only the supported currencies to avoid invalid requests.
Use the returned balance account details to monitor and manage account activity.