ABA files Westpac bank quirks troubleshooting

Westpac ABA File Self-Balancing: What It Is and How to Handle It

Westpac requires ABA files to include a self-balancing debit entry that offsets the total credits. Here's why it exists, when it applies, and how to create a compliant file.

createABA Team ·

Westpac requires ABA files to include a self-balancing debit entry. Upload a standard ABA file (credits only) and you’ll get an error like “file is not balanced” or “net value must be zero”. Here’s what that means and how to fix it.

What Is a Self-Balancing ABA File?

A standard ABA file contains only credit records. Each detail line moves money from your account to a recipient. The total of all credits equals the total amount being paid out.

A self-balancing ABA file includes an additional debit record that equals the total of all credits. This debit entry points back to your own account, so the net value of all transactions in the file adds up to zero.

Think of it as the file saying: “I’m paying out $10,000 in credits, and I’m recording a $10,000 debit from my own account to balance the books.”

Why Does Westpac Require This?

Westpac uses self-balancing as an internal integrity check. By requiring the debit and credit totals to net to zero, Westpac’s batch processing system can verify that:

  1. No records were dropped or duplicated during transmission
  2. The total debited from your account matches the total credited to recipients
  3. The file wasn’t corrupted between your computer and their system

Most other Australian banks (ANZ, NAB, CBA) perform this verification internally and don’t require you to include the balancing record yourself. Westpac has historically left this responsibility with the file creator.

When Does the Requirement Apply?

The self-balancing requirement applies when you are uploading ABA files through Westpac Online Banking (consumer/SME portal) or Westpac Corporate Online. It applies to both payroll and supplier payment runs.

If you’re using Westpac via a third-party accounting package that has a native bank feed integration (like Xero’s direct payment submission), the accounting software usually handles the self-balancing record for you. The issue arises when you’re generating the ABA file yourself and uploading it manually.

What the Balancing Record Looks Like

In the ABA file format, each detail record (type 1) has a transaction code field. Credit transactions use codes like 50 (pay) or 53 (payroll). The balancing entry uses transaction code 13 (debit) and points back to your own BSB and account number.

A file with three $500 credit payments would have:

0 ...header...
1 123-456 987654321 50 000050000 SMITH JOHN           payroll         ...
1 234-567 123456789 50 000050000 JONES SARAH          payroll         ...
1 345-678 987654321 50 000050000 BROWN MARK           payroll         ...
1 062-000 111111111 13 000150000 YOUR BUSINESS NAME   self-balance    ...
7 999-999            000150000 000150000 000000003           ...footer...

The balancing record debits $1,500 from your account (your BSB + account number), and the footer shows matching credit and debit totals.

How to Create a Self-Balancing ABA File with createABA

createABA handles the self-balancing record automatically when you enable it. On the Bank Details step of the conversion wizard:

  1. Enter your bank’s BSB, account number, and business name as normal
  2. Check the “Westpac self-balancing” option
  3. createABA adds a balancing debit record pointing to your own account before generating the file

You don’t need to add a row to your spreadsheet or do any manual calculation. The total is computed from your payment rows and the balancing entry is inserted automatically.

Quick Checklist for Westpac ABA Uploads

  • Self-balancing option enabled in your file generator
  • Your own BSB and account number entered correctly (the debit targets your account)
  • Transaction codes on credits are 50 (general) or 53 (payroll), not 00
  • Account names are 32 characters or fewer and contain only alphanumeric characters and spaces
  • BSBs are in XXX-XXX format with a hyphen
  • File description field is 12 characters or fewer

What If Westpac Still Rejects the File?

If the file is still rejected after adding the self-balancing record, check:

  • User ID (APCA ID): Some Westpac setups require a specific 6-digit User ID issued to your business. The default 000000 works for most users, but if Westpac has assigned you a specific ID, enter it in the header.
  • File description: Must be 12 alphanumeric characters or fewer; avoid special characters.
  • Date format: The ABA header uses DDMMYY. A date of 10/04/2026 becomes 100426. Verify your generator is formatting dates correctly.
  • Contact Westpac business banking: If the above checks pass and the file is still rejected, Westpac business banking support can inspect the specific error code from their batch processing system.

Need a self-balancing ABA file for Westpac? Create it with createABA in under 30 seconds →

Ready to create your ABA file?

Upload your CSV or Excel file and download a valid ABA file in under 30 seconds. No data leaves your browser.

Try createABA free →