Account Funding: Customer sub-accounts
Release Details
Release Date: April 16th, 2025
Release Type
Informational – optional action from platforms
Summary
The Account Funding product now supports sub-accounting. It's common for platforms to offer their customers the ability to create multiple accounts. For instance, a brokerage may allow customers to open separate trading accounts for tax optimization, risk management, differentiated trading strategies, or to simply organize investments by distinct goals.
As a result, it's essential that Zero Hash provides the flexibility to segregate transactions based on the specific account in use - enter Customer sub-accounts.
There is a new optional query param called the account_label
which has been added to the following Account Funding SDK's
Read the end-to-end integration guide to see this new feature in action. At a high-level, here are the impacts:
Funding
- The Platform will acquire an access token the same way they do today, just additionally specifying an
account_label
on the call - Zero Hash will save this and attach it to an address once the user selects the Asset and Network
- Once the Customer deposits, Zero Hash will:
- Recognize the deposit, where the account will have the specified
account_label
- Auto-convert the asset to USD
- Auto-transfer the USD to the Platform (if configured for this)
- Send a Fund webhook with the specified
account_label
in the payload
- Recognize the deposit, where the account will have the specified
- The Platform will also be able to retroactively query GET /fund/transactions and see the proper
account_label
associated with the transaction
Withdrawal
- The Platform will acquire an access token for the Account Link SDK identically to how they do today. No change here
- The Platform will acquire an access token for the Withdraw SDK the same way they do today, just additionally specifying an
account_label
on the call - The Customer will initiate a withdrawal on the SDK, triggering the following
- Auto-convert from the Float account to the asset (no change)
- Auto-disburse the asset to the destination address, debiting the Customer's account with the specified
account_label
- Send a Payments webhook with the specified
account_label
in the payload
Products Impacted
Account Funding - this impacts both the SDK and API