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.

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 |
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. 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 |
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 |
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 |