Troubleshooting for batch payments

If you're getting errors when trying to upload a batch payment file to your bank, there are a couple of things you can check before contacting your bank.

Error messages

  • There are errors on all Payment Lines in this Batch followed by Payment to xxx - Payee Code is a Required Field - check your bank account number in Xero, as well as your suppliers. Both account numbers must be entered in the correct format.
Once you've downloaded the batch payment file, you don't need to open it. Just save it to your computer and upload it into your online banking from there. The exception is if you're uploading the file to a New Zealand HSBC account.

Check your bank account details

To check the bank account details for your organisation:

  1. In the Accounts menu, select Bank Accounts.
  2. For the relevant bank account, click Manage Account, then select Edit Account Details.
  3. Make sure the correct bank is selected from the list displayed (not just typed in), and the correct Account Number is entered.
  4. Edit the details if required and click Save.
  5. Re-export the batch file and try uploading to your bank again.

Check the batch payment details

To check the batch payment details for each supplier:

  1. Find your batch payment.
  2. Click on the batch to open.
  3. Click Options, then select Edit Batch.
  4. Make sure that the Payment Date is not in the past. If you're exporting the file and uploading it at another time, set this to a future date.
  5. Check that the following fields have information in them:
    • Particulars, Code, Reference – this is what appears on your bank statement.

    • Bank Account – the supplier’s bank account. The account number should have 16 digits (2-4-7-3).

    • Particulars, Code, Reference – this is what appears on the supplier’s bank statement. Ensure there are no commas in any of the payment reference fields as it can cause batch files to fail validation when importing to your bank.
  6. Enter in any missing details and click Save.
  7. Re-export the batch file and try uploading to your bank again.

Sometimes, when the file is opened instead of saved, the file extension changes to .txt or .aba.txt, which will cause an error. If this happens, rename the file and make the extension .aba before uploading to your bank.

Contact your bank if you're still having trouble uploading the file

If you are still having trouble uploading a batch file to your bank and you receive an error message, please contact your bank and confirm:

  • What the error message means. Once you know this, you can fix the details in Xero and re-export the file.
  • That your bank account is set up to accept batch payment files.

If you still get errors, click Contact Xero Support at the end of this page, let us know the details of your query and attach a screenshot of the error message.

You might also be interested in