Ledger Accounts

for use cases where segregating funds and reporting or keeping a running account balance is required, ledger accounts are available these virtual ledgers can be creating under a virtual account number, extending its functionality funds can be paid out from the ledger directly as each ledger maintains its own balance, this allows you to use the ledger as a separate pool of funds, so only the amount paid into the account is able to be paid out feature virtual account numbers ledger accounts bsb and account number ✔ ✔ ✔ ✔ payid available ✔ ✔ ✔ ✔ funds segregation from maccount ❌ ✔ ✔ consolidated transaction history ❌ ✔ ✔ current balance ❌ ✔ ✔ account statement with running balance ❌ ✔ ✔ bpay ❌ ✔ ✔ the following payment types settle directly into ledger accounts via the bsb and account number npp transactions, including payto direct credit rtgs and imt payments from your maccount or other ledger accounts the following payment types can be paid directly from a ledger account npp payments to a bank account or payid direct credit payments to a bank account bpay, using a biller code and crn external direct debits; where funds are debited from your ledger account by a third party payments to your maccount or another ledger account creating a ledger account ledger accounts are not enabled by default in sandbox please contact monoova to enable this feature on your sandbox account ledger accounts are created using the create ledger account docid\ k4p xliihgllpna3jhk8s endpoint and can be linked to an existing virtual account number, or a new account number can be provisioned as part of the creation process only one virtual account number may be linked to a ledger at any time, and the virtual account number must remain active while the ledger is active after creating a ledger account you can create a payid linked to the attached virtual account number if you are using an existing virtual account number any pre existing payid associated with the account will remain attached and can be used to pay into the ledger account ledger accounts are queried using the ledgeruniquereference you supply during the creation process, and the ledgeraccountnumber we provide in the response these ids are used when retrieving reports and when closing a ledger account closing a ledger account ledger accounts can be closed with the close ledger account docid 2pcoddgrmsbwtofbola46 endpoint before closing a ledger account the balance must be $0 00 you can choose whether to deactivate the attached virtual account number and payid at the same time the ledger account is closed by setting forcedclose to true this parameter is false by default if the attached virtual account number remains active you can choose to attach it to a new ledger account balance and financial reporting each ledger keeps a record of receivables and payables made within the ledger allowing you to request a segregated report showing all transactions with a running balance, and the current balance of the ledger to query the ledger balance, call the retrieve current ledger balance docid\ i724r1gdajbvtjcjjnqy6 endpoint this is a lightweight endpoint that returns the balance at the time we receive the request, along with information about the ledger and its status for detailed reporting, call the retrieve transactions for a ledger docid\ jqfpsvdzeerv6odx amdx endpoint this returns a paginated list of transactions in or out of the ledger, including the datetime, amount, rolling balance, and payer or payee information this endpoint can be used in place of other receivables reporting endpoints if you primarily rely on the ledger account the retrieve dinancial details of a ledger docid\ qwvglab5s4jw9higdmboq endpoint returns the available balance, transaction limits, last transaction date and attached virtual account number details for a ledger account each ledger account has its own transaction limits, so this endpoint is helpful when identify if you're close to reaching the available limit transferring funds between accounts funds can be transferred between maccounts and ledger accounts using the execute a transaction docid\ nmknovkipahgvaev5znxp endpoint it may be necessary to transfer between maccounts or ledger accounts in instances where funds cannot settle to the ledger account directly, such as bpay or card payments