A transfer out of a Treasury Account is an Account Transfer. This page focuses on the step-by-step experience and how to simulate the result.
The Transfer screen
When you start a transfer, the Transfer screen shows:- Transfer from - A dropdown to select the source Treasury account.
- Who are you transferring to? - A search bar for finding saved recipients.
- New recipient button - a button that opens the Enter recipient details page where new recipient’s details are entered.
- Recipients list - provides a list of saved recipient accounts. Select the one that you want to transfer to.
The Enter amount screen
Once you’ve selected the recipient, the Enter amount screen shows:- You transfer exactly: the amount taken from your Treasury Account balance.
- Recipient gets exactly: the amount the recipient receives after fees.
- Total fees (included): the fees, already factored into the figures above.
- Transfer from: the source Treasury Account.
- Recipient: the recipient’s name plus their BSB, account number, account name, email, and phone number.
- Should arrive: the expected delivery time (typically within a few hours on weekdays; the next working day on weekends).
Worked example
Transferring AUD 788 from the Amuseables Espresso Cup Treasury Account, the recipient receives AUD 716.36 after AUD 71.64 in fees. The available balance of AUD 1,388.00 sits on that specific Treasury Account only; no other account is touched.After you confirm
Once you confirm, you will see a “Your transfer has been created” screen. At this point the transfer’s status is Processing; it has been created but has not yet settled. This screen summarises the transfer (amount sent, fees, recipient gets, recipient details, and expected arrival) and shows a Balance ID at the top, for examplepo_1tjreKKucrcM. This Balance ID is the transfer’s unique identifier (its uuid), and you will need it to simulate the transfer’s outcome in the next step. You can copy it directly from this screen.
1
Enter the amount and recipient
On the Enter amount screen, set the amount and review the recipient and fee details, then click Continue.
2
Review and confirm
Check the summary and confirm the transfer.
3
Transfer is created (Processing)
You see the confirmation screen. The status is Processing, and a Balance ID is shown; copy it for the next step.
Simulating a transfer outcome (API)
A newly created transfer stays in Processing. To test how your integration behaves when a transfer succeeds or fails, you can simulate its final outcome with the simulate transfer API. Method:POST
URL: {{v2_url}}/transfers/simulate (for example, https://api.cleverhub.co/api/v2/transfers/simulate)
Headers:
Not sure where these come from? See where to find
app-id and secret-key.
After the call, the transfer moves out of Processing to the status you chose, and the result is reflected in the account’s balance and transaction history. Use
completed to verify the successful path, and failed to confirm how your integration handles failed transfers.