Payment Management is a sub-domain of Obligation Management (OBLMGT). This page contains information and artefacts for Digital Service Providers (DSPs) who have or are interested in developing web services that enable a business or their intermediary to manage their payments to the ATO. The services described below are only deployed on the SBR ebMS3 platform.

For ease of use, services have been organised into the following business processes:

  • Set or cancel a direct debit – Allows users to request for the ATO to initiate a single direct debit (DD) of a client's nominated bank account where a Direct Debit Authority is already be in place or to cancel a single DD without cancelling the Direct Debit Authority.
  • Payment plans – Allows users to view an account’s eligibility to a payment plan and calculate, create, recalculate, update, cancel, list and view payment plans.
  • Generate payment reference number – Allows users to proactively manage their debt by providing the ability to generate PRN details for available accounts and roles.
Image
More information

The ATO provides a number of common artefacts and reference documents to support DSPs (such as the ATO Service Registry and the ATO Service Support Versioning Strategy). These can be found here.

Set or cancel a direct debit

Direct Debit (2018)

Service Version 0003.2018
Service Actions Add – Allows authorised parties to request the ATO to initiate a single direct debit of the client’s nominated bank account for selected accounts/role, where a Direct Debit Authority is already recorded. This service will not add a direct debit authority.

Cancel – Allows authorised parties to cancel a previously requested single Direct Debit. This service does not cancel the Direct Debit Authority.
Name Version number Status Size Published date
ATO DD.0003 2018 Package v1.0 Contents (DOCX) 1.0 Final 226KB 30 August 2018
ATO DD.0003 2018 Package v1.0 (ZIP) 1.0 Final 2.33MB 30 August 2018
ATO DD.003 2018 Business Implementation Guide (DOCX) 1.0 Final 287KB 10 January 2019

Direct Debit (2016)

Service Version 0002.2016
Service Actions Add – Enables authorised parties to request the ATO to initiate a single direct debit of the client’s nominated bank account and also the ability to cancel a previously requested single direct debit.

Cancel – Allows for a cancellation of a previously requested single Direct Debit and does not cancel the Direct Debit Authority.
Name Version number Status Size Published date
ATO DD.0002 2016 Package v1.3 Contents (DOCX) 1.3 Final 232KB 20 September 2018
ATO DD.0002 2016 Package v1.3 (ZIP) 1.3 Final 572KB 20 September 2018

Back to top

Payment plans

Service Suite:  Payment Plan (PMTPLN) 2020
Service Name: Payment Plan Eligibility (PMTPLNELG)

Service Version 0003.2020
Service Actions List – Provides an account’s eligibility for a new payment plan.  Available payment plan options are returned for an eligible account, and the payment plan identifier is returned for an account with an existing active payment plan.  The request can be for a specific account or for all accounts belonging to a client.

Service Name:  Payment Plan (PMTPLN)

Service Version 0003.2020
Service Actions

Get – Provides a view of a current or historical payment plan. Payment plan details include the payment method, payment schedule and estimated GIC.
Calculate – Calculates a payment plan for an account, including the estimated GIC payable. The calculation may be requested multiple times with different input parameters (e.g. instalment amounts, frequency) to view the impact on the GIC amount payable.
Submit – Creates a payment plan for an eligible account. The payment plan details to be provided include the payment plan amount, payment method and payment schedule. The created payment plan details returned include the Payment plan identifier and Payment reference number.
Calculate Update – Recalculates an existing active payment plan based on changes provided.  The update calculation may be requested multiple times with different input parameters to view the impact on the payment plan.
Update – Updates an existing active payment plan schedule.  The updated payment plan details are returned including the changed payment schedule.
Cancel – Cancels an existing active payment plan on an account.

List – Provides a list of current and historical payment plans.

 

Name Version number Status Size Published date
ATO PMTPLN 2020 Package v1.2 Contents (DOCX) 1.2 Final 230KB 20 May 2021
ATO PMTPLN 2020 Package v1.2 (ZIP) 1.2 Final 10.7MB 20 May 2021
ATO PMTPLN 2020 Business Implementation Guide (DOCX) 1.3 Final 156KB 13 March 2025

Back to top

Generate payment reference numbers

Service Name:  Payment Reference Number (PRN)

Service Version 0001.2016
Service Action Get – Allows retrieval of a payment reference number (PRN) for selected accounts/roles.
Name Version number Status Size Published date
ATO PRN 2016 Business Implementation Guide (DOCX) 1.0 Final 224KB 16 November 2017
ATO PRN.0001 2016 Package v1.4 Contents (DOCX) 1.4 Final 199KB 19 September 2024
ATO PRN.0001 2016 Package v1.4 (ZIP) 1.4 Final 551KB 19 September 2024

Back to top


SBR ebMS3 webservices artefacts

The Australian Taxation Office has developed an ebMS/AS4 implementation extending on the SBR initiative to simplify Business to Government reporting obligations and aligning with the messaging standards chosen for Superannuation Reform. While this implementation replaces the existing SBR message wrapping, it does not replace the eXtensible Business Reporting Language (XBRL) body provided in SBR web services, in fact the ATO implementation of the new system reuses the existing SBR XBRL message body for the majority of the services provided in the new format.

The following information describes how to implement web services consuming the ebMS3/AS4 messaging standard (SBR ebMS3). 

  • SBR ebMS3 web service implementation guide
    The SBR ebMS3 web service implementation guide (WIG) describes common technical components and services that are re-used by all business services. The common services include whole of government gateways that expose services and supports the protocol for message exchange, standard message types, standard response time service levels, standard message structures, a security token service, and a standardised approach to handling business error conditions and transport exceptions.

    There is a separate SBR Core Services WIG. 
  • SBR ebMS3 software developer kit guide
    The SBR ebMS3 software developer kit (SDK) guide identifies the key components and functionality that comprise the SDK solution. Some of these components are re-used from the previously released SBR Core Services SDK and hence the reader is pointed to the reference for existing documentation. For the new components, this document will outline the usage details and the API specification (where applicable).
Name Version number Status Size Published date
SBR ebMS3 Web Services Implementation Guide (DOCX) 1.7 Final 1.96MB 14 December 2017
SBR ebMS3 SDK Developer Guide (DOCX) 1.3 Final 1.80MB 18 June 2015
Last updated:
Last updated:
Page ID: 344
Payment Management (PMTMGT)