Authentication Failure error

Authentication Failure error

Note: This article is for clients who manage their own tax and have received a  Rejected status with error reason "1 : Authentication Failure" when a payday file has been submitted.

iPayroll manages any issues for any clients we are a PAYE Intermediary for.

An authentication failure indicates that the myIR credentials used to send the payday file are not valid.

It is possible that the user who is currently connected with their myIR credentials in iPayroll has since been deactivated as a user in myIR.

If this is the case, you need to reset the connection to the Inland Revenue in iPayroll, by disconnecting and reconnecting to myIR, using the credentials of an active myIR user who has payday filing permissions in myIR.

You will probably also need to update the tax contact for this organisation.

Disconnect from Inland Revenue in iPayroll

Note: The user who can perform this action must be a Paymaster who has access to all employees.

  1. In iPayroll, go to Tax > Tax Options.
    You will see the connection status at the top of the page.
  2. Click Disconnect.
    A Confirm Disconnect prompt displays.
  3. Click Disconnect.
    The connection status updates.

Assign permissions in myIR

In order for Inland Revenue to accept your payday files, the person whose myIR login is used to connect in iPayroll must have payday filing permissions set in myIR.

Make sure the user who will create the connection in iPayroll has payday filing permissions.

If the myIR Owner is the person whose credentials are used to connect in iPayroll, no further change is required in myIR, as the myIR Owner already has payday filing permissions set.

If, however, the person whose credentials will be used to connect in iPayroll is not the myIR Owner, the myIR Owner must give permission to that user in myIR.

Inland Revenue (IR) instructions for granting access

Inland Revenue have instructions for a myIR owner to grant access to other myIR users:
Give access to your payroll account in myIR.

Grant EMP access to your employee. The tax type required is Payroll Returns and should end in the letters EMP.

Other Inland Revenue articles that may be of use:

Reconnect to myIR from iPayroll

The reconnection then needs to be completed by a user whose myIR credentials have payday filing permissions.

Note: The user who can perform this action must be a Paymaster who has access to all employees.

  1. In iPayroll, go to Tax > Tax Options.
    You will see the connection status at the top of the page.
  2. Click Connect.
    The myIR login page is displayed.
    mceclip0.png
  3. Enter the myIR login details of the person who has payday filing permissions.
    Note: This can either be the myIR Owner's credentials, or another myIR user who has been given payday filing permissions by the myIR Owner.
  4. Click Login.
    Your new connection should now be established.

Note: The connection will display which iPayroll user entered myIR user details to connect to the Inland Revenue. As we do not store the myIR credentials entered into myIR, we are unable to advise which myIR user details were entered.

Important: This task should only need to be completed once. However, it is possible that either the connection could be broken, or someone could disconnect from the service. If this happens, a Warning message will display in two areas of the application:

  1. In Payroll > Confirm, when confirming the payroll, and
  2. In Tax > Payday Filing History.

Resend the payday file

Once a connection is established, with a myIR user who has payday filing permissions in myIR, you will then need to resend your payday file manually.

Note: The user who can perform this action must be a Paymaster who has access to all employees.

Note: If there is more than one file to send, the Send button will only be active on the oldest file. Once that file has been Submitted Successfully, the next file will be available to send.

To resend a payday file

  1. Go to Tax > Payday Filing History.
    You will see the rejected payday file in the Payday Filing History table.
  2. Click Send.
    The Status should update to Submitted successfully.
  3. Repeat step 2 until all unsent payday files have been submitted successfully.

The initial status for an accepted payday file is Submitted successfully. Overnight, the payday file will be processed by IR. The next day, you should expect to see the status update to Accepted successfully. This is the final status for a payday file.

Note: If the status does not update from Submitted successfully to Accepted successfully within a day, it is likely the IR have chosen to review the payday files further.

Update the tax contact

You need to make sure the tax contact is kept up to date, in case the IR needs to contact you in regards to your payday files.

The tax contact details are included in each Employee Information (EI) payday file.

Note: The user who can perform this action must be a Paymaster who has access to all employees.

  1. In iPayroll, go to Tax > Tax Options and scroll to the Tax Contact section.
  2. Update the tax contact details.
    Note: Position is optional, but all other tax contact fields are mandatory.
  3. Select Save.
    • Related Articles

    • Unauthorised Delegation error (if you manage your own tax)

      iPayroll manages any issues for any clients we are a PAYE Intermediary for. This article is for customers who manage their own tax and have received an Unauthorised Delegation error when a payday file has been submitted. If your tax is managed by ...
    • Detailed Set up of Two-Factor Authentication

      Industry standard two-factor authentication (2FA) gives you and your organisation even more protection by requiring an extra identify confirmation at log in. Use these instructions to set up two-factor authentication if you do not access the Kiosk ...
    • Detailed Set up of Two-Factor Authentication to Access the Kiosk on a Smartphone

      Use these instructions to set up two-factor authentication if you access the Kiosk using a smartphone. Note: If you do not access the Kiosk via smartphone, see Detailed Set up of Two-Factor Authentication. Note: If you have installed the iPayroll ...
    • Reset Two-Factor Authentication

      Reset Two-Factor Authentication as a user If you access the Kiosk using a smartphone, see Disable or Reset Two-Factor Authentication in the Kiosk on a Smartphone. You may want to disable (optional 2FA) / reset (compulsory 2FA) your two-factor ...
    • How do I repost to Xero?

      Repost Historical Information to Xero This article is for customers who use Xero Accounting and post your GL to Xero when you confirm a pay. If there is an error in the process, a message will display on the confirm screen and a system generated ...