Connecting Tanda and KeyPay

Add KeyPay to your Tanda account by going to Settings > Integrations > Payroll Integrations > New Payroll Integration and select KeyPay:

You'll need to fill in a few details from your KeyPay account to successfully connect the account, including ABN and API key.

You can find your API key in KeyPay in the Payroll Settings tab on the dashboard > My Account.

Here you will see your API key:


If you have more than one business in your KeyPay account, you'll also need to enter the KeyPay Business name in Tanda, ensuring you enter the name exactly as it appears in KeyPay. Your Business Name can be found in the Payroll Settings tab on the dashboard > Details tab.

Payroll Configuration

Tanda sends data through to KeyPay via Timesheets. So we need to ensure:

  1. Employees have External IDs in KeyPay and these have been entered on their Tanda profile under Payroll > Payroll ID.

  2. Employees are setup for Timesheets by selecting 'Uses Timesheets' on each employee's profile, under the Employment Details tab.

  3. We've mapped Award rules and Leave Types in Tanda (under the Compliance tab) to Work Types in KeyPay (Payroll Settings > Work Types).


In Tanda, approve timesheets > click Preview & Export > followed by Export to Payroll Software:

Then, in KeyPay, timesheets that have already been approved in Tanda will automatically be approved.

Next, head to Pay Runs and add a new pay run. Enter the pay run dates so they match your pay run in Tanda and ensure you've opted to import timesheets for this pay run. Then click 'Create'. You should then see the timesheets for Tanda in KeyPay.

Once you've got a pay run with timesheets imported, you've completed the export from Tanda. From here you can process payroll as you usually would in KeyPay.


I've made changes to an employee's timesheet and need to re-export - what's the best process to do this?

If you've already created a pay run for an employee, but have had to make changes to the total hours being paid, you'll need to delete the existing pay run for the employee from KeyPay and re-import the updated one.

If additions are being made to the pay run for the employee (i.e. only an allowance is being added, and no change is made to the total hours paid), a re-import of just the allowance will stack onto the existing pay run in KeyPay.

An employee worked a shift that spanned across two pay periods, what gets exported from Tanda to KeyPay?

If you run pay periods Monday - Sunday, and an employee works a shift from Sunday 9pm to Monday 2am, all hours of the shift will be exported and paid through KeyPay, despite the fact that 12am - 2am on Monday fall in the new pay period.

The exception to this is when shifts are rostered back to back. If the employee works 9pm - 12am in team A, then 12am - 2am in team B, the two hours in team B will be included in the new pay period.

Did this answer your question?