Virtual Account Numbers

virtual accounts are similar to standard bank accounts they have unique account numbers, support incoming and outgoing payments and are compatible with real time payment options like payid and osko these accounts can be generated using the create a virtual account docid\ qtj07qigl1ytc3ykxaeek endpoint these account numbers can be used along with the returned bsb to receive payments from any bank in australia payments to an invalid bank account number, i e one that has not been created or is inactive, will be returned by monoova to the remitting institution an optional unique id can be linked to each account number for your reference if a unique id is not provided, monoova will generate and return one automatically if isactive is omitted, it will default to false this can be changed to true via the update a virtual account status docid\ lgeayfj206vqxdn7mjpqj endpoint payment reconciliation to reconcile payments received to your virtual account numbers, you can request a received transactions report docid\ t3ltjm3jpaztfpyytdl7u or subscribe to webhooks docid\ ir nhxjcx2bmybxqizidd as virtual account numbers can receive de, npp, and rtgs payments it's recommended you subscribe to the nppreceivepayment and inbounddirectcredit events at minimum batch creation you can create up to 50,000 virtual account numbers at once using the /receivables/v1/batchcreate docid\ rvz5lirzqndkh92j5fnnm endpoint this endpoint allows a maximum of 1,000 accounts to be created where isactive is true, and is recommended for any use case where more than 100 accounts need to be created in a short timeframe multiple batches cannot be requested at the same time, you have to wait for the completion of a batch before requesting a new one only one active batch is permitted at a time, and the system will return an error if there is an existing batch in progress to check the status of a batch you have submitted call the /receivables/v1/batchstatus docid\ ros3h68px0bruexhs3ol7 endpoint the batch create api also supports a lightweight option whereby many accounts can be created by submitting a single line, which reduces the filesize required this option can only create active accounts, hence you can only request the creation of 1000 accounts in one request for this method, all accounts will be created with the same specified name, and clientuniqueid’s cannot be specified will be automatically generated updating account status virtual account numbers can be made active or inactive using the update a virtual account status docid\ lgeayfj206vqxdn7mjpqj endpoint inactive accounts will have all payments rejected and returned to the payer