Guide to Akahu Payment integration

These instructions help you connect your payroll account to Akahu for the first time:

1. Log into your payroll platform.
2. Click the  Businesss menu.
3. Click the Payroll Settings submenu.
4. Under Business Management, click Integrations.
5. Click the Add button for Akahu.
   
6. Click the checkbox to agree to pay $5 per month charge.
7. Click the Connect to Akahu button.
   
   
   

   Helpful Hint

   You will be redirected to the Akahu screen.

8. Click the Continue button.
   
9. Enter your email address registered with your Akahu account.
10. Click the Continue button.
    
11. Enter the 6-digit verification code sent to the email you entered in the previous step.
    
12. Choose your bank.
    
13. Enter your bank credentials.
14. Click the Continue button.
    
    
    

    Helpful Hint

    ANZ is only used as a sample bank in this scenario.

15. Enter your verification code.
16. Click the Continue button.
    
17. Choose the bank account you would like to connect to the payroll platform.

    Helpful Hint

    You can select more than one bank account. To see a list of ‌bank accounts you can link, please refer to Akahu's list here: Supported Integrations - Banks.

18. Click the Connect button.
    
    
    

    Helpful Hint

    You will be taken back to the payroll platform.

19. You may choose to enter your Code and Reference, which are optional.

    Important

    The Code and Reference are statement details to be shown on the source and destination accounts. They can both be a maximum of 12 characters made up of upper case and lower case letters, digits 0-9, and “-” or “_”.

20. Click the Save button.
    
    
    

    Helpful Hint

    You have now enabled your Akahu integration.

    

1. Log into your payroll platform.
2. Click the  Pay Runs menu.
3. Select the required finalised pay run
4. Click the Pay with Akahu button.
5. Select your bank account from the Bank Accounts drop-down.
6. Click the Confirm button.

   Helpful Hint

   Clicking the Confirm button prompts a validation process to take place to check for a valid NZ bank account. If successful, we will send the payment via your Akahu payment service and connected bank account. If we detect any problems, the platform will show you a warning with the details on your screen.

   
   
   

   Helpful Hint

   Once completed, the Pay with Akahu button will change to a View Akahu Payments button. If there are any employees that have their bank details set to manual payment or cash/cheque, then once you finalise the pay run, a warning message will appear and it will not stop the pay with Akahu process. There are some limitations to the payments you can make. For example, the maximum dollar amount for any payment is $50,000.

   

1. Log into your payroll platform.
2. Click the  Pay Runs menu.
3. Select the required finalised pay run that you processed with Akahu.
   
4. Click the View Akahu Payments button.
   
   
   

   Helpful Hint

   Doing this will launch a side panel where you can see information about the last pay run and the information sent via Akahu and the status of the payments:

   • Payment file.
   • Payment date.
   • Payment code.
   • Payment reference.
   • Number of payees.
   • Employee Payments:
     • Name
     • Account number.
     • Amount.
     • Status.
     • Error Message.
     • Retry.
   • IRD Payment:
     • IRD.
     • IRD number.
     • Amount.
     • Status.
     • Error Mssage.
     • Retry.
   
   
   

   Helpful Hint

   Similarly, when you log into your Akahu account, you can see the status of each payment. Each payment will show as sent, failed, or processed. If any of the payments have failed, you can tick the Resubmit tick box, then click the Retry button. Doing this will launch the modal window again in case you want to choose a different bank account.

As long as the payment file has not been sent to the bank you can edit and delete your pay run and associated payment file.

1. Log into your payroll platform.
2. Select Pay Runs.
3. Perform and Finalise your Pay Run.
4. Click the Pay Run Actions button.
5. Select Unlock Pay Run. For instructions on how to do this read more here.
6. You are then able to edit actions, click on each employee and change details such as dimension codes within the pay run as if running it for the first time.
7. Complete the actions you need to complete.
8. Finalise again.
9. Select Send to Akahu.
10. Alternatively, when you click unlock, select Delete Pay run.
11. Confirm Delete.

To disable your Akahu connection, follow these instructions. 

1. Log into your payroll platform.
2. Click the  Businesss menu.
3. Click the Payroll Settings submenu.
4. Click the Integrations button.
5. Click on the  button for Akahu.
   
6. Click the Disable button.