Partner API
Build payroll integrations on the same surface that powers the myaccountant customer product. Employees, pay runs, super contributions, STP lodgement and a headless calculation engine, all behind a single API key.
Three things to know up front.
Compliance is bundled.
STP submissions go through the embedded ATO gateway. Super contributions go through Beam, our SuperStream clearing-house. You do not need separate SBR or SuperStream vendors.
The data model is exact.
Pay items route by stable ATO master ids, MPIT_AU_001 is Ordinary Earnings, MPIT_AU_003 is Overtime, never by user-mutable names. This is what makes STP submissions correct on the first try.
One key, many companies.
A partner tenant can own and operate any number of myaccountant company files. Each company stays isolated, its own employees, pay runs, STP submissions and super contributions, with tenant boundaries enforced server-side.
Who it's for.
Push normalised hours into a draft pay run, watch myaccountant compute PAYG and Super Guarantee, then hand the finalised pay run to the ATO. The ingestion endpoint is idempotent, resubmit the full timesheet whenever your source of truth changes and the pay run resynchronises without duplicates.
Operate the full payroll cadence on behalf of your clients. Declare a recurring pay schedule, let the daily sweep auto-draft the next pay run, approve, lodge STP, contribute super. One API key spans every client company in your tenant.
Manage employees and pay history in your existing system. Call the headless calculation engine for Australian PAYG, ETP, Schedule 7 unused leave, Section 83-170 redundancy splits and Super Guarantee, no pay run, no employee record, no side effects in our database.
Hospitality, construction, healthcare. Embed Australian payroll behind your product so your customers never leave it. The endpoints are vendor-neutral, the data model is industry-agnostic.
What you get.
Compliance is bundled.
Single Touch Payroll submissions go through the embedded ATO gateway, super contributions go through Beam, our SuperStream clearing-house. No separate SBR registration, no separate vendor invoice. ATO validation feedback comes back in the response body so you can surface it directly to your customer.
Headless calculation.
Stateless calculators for PAYG (every Tax Treatment Code on Schedule 1), ETP (all eight codes on Schedule 11), redundancy split under Section 83-170, Schedule 7 unused leave, extra-pay-year averaging, Super Guarantee, leave accrual and preservation age. Same input, same output, no database writes. Use myaccountant as a calculation oracle.
Right the first time.
Pay items route by stable ATO master ids, MPIT_AU_001 is Ordinary Earnings, MPIT_AU_003 is Overtime, never by user-renamable type names. Timesheet imports upsert on a stable key. Pay schedules carry their own cursor. The Idempotency-Key header is honoured on every write for 24 hours. Retry logic is the boring path, not the failure path.
The surface.
Every endpoint is idempotent on retry within a 24-hour Idempotency-Key window, rate-limited at the tenant level, and returns a uniform response envelope.
Employees. Full lifecycle, create, update, manage tax, super, bank and leave detail, deactivate. Soft-delete preserves history.
Pay runs. Explicit partner-controlled creation, declarative recurring pay schedules, or pull-based timesheet ingestion (Tanda, Deputy, or your own normalised payload).
Calculations on demand. A headless engine for PAYG, ETP, redundancy splits, Schedule 7 unused leave, extra-pay-year averaging, Super Guarantee, leave accrual and preservation-age lookups. No pay run required.
Single Touch Payroll. ATO single-touch payroll lodgement (Submit, Update, Full File Replacement) via the bundled gateway.
Superannuation. Beam clearing-house contributions including SuperStream pre-validation. Fail fast on USI mismatches and member-verification errors before the batch lodges.
Compliance artefacts. Payslips (PDF and JSON), ABA bank files, end-of-financial-year finalisation events.
The data model.
Your API key identifies a tenant. Every request specifies the target company with an X-Company-Id header. Tenant boundaries are enforced server-side, an API key cannot see or modify a company outside its tenant.
Your organisation. Identified by API key.
Your client. Acme Pty Ltd, for example. One tenant can operate many companies, each isolated.
With tax, super, bank and leave detail underneath. Soft-deleted employees stay in historical pay runs.
Recurring template. Anchor period and frequency declared once, draft pay runs auto-materialise ahead of each pay date.
Draft, Preview, Approved, Finalised. Immutable once Finalised, corrections happen through STP Update, never by editing rows.
Submit, Update, or Full File Replacement against the ATO gateway. State machine is exposed directly.
Beam contribution lodgement. SuperStream pre-validation runs before submission.
Pay runs are immutable once Finalised. Corrections happen through STP Update, never by editing rows. Snapshots of pay-item types are captured per pay run so historical lodgements stay correct even when a customer renames their pay items later.
On the way.
Subscribe to events like pay-run finalised, STP submitted, super lodged. Delivery is signed with HMAC-SHA256 so receivers can verify origin. Not live in v1, the workaround for now is to poll the read endpoints on a schedule. Targeted for the next partner-API milestone.
ATO rejection codes (for example, CMN.ATO.PAYEVNTEMP.000243) are terse and inconsistent. We are building an explanation layer that pairs each rejection with the specific cause and a suggested fix. Not in the API yet, the raw rejection code comes back in the response so you can route it to your own handling for now.
API keys are provisioned by hand. Send a short brief, what you are integrating, who your customers are, what volume you expect, and we will respond within two business days with sandbox credentials and a 30-minute call slot.
support@myaccountant.com.au
No payment details required.
