Skip to content
Log in

Australia Post shipping provider

On this page

Australia Post is a supported shipping provider in StoreConnect. At checkout, StoreConnect can retrieve live shipping rates from Australia Post based on the cart contents, the Stock Location address, and the delivery address. Once an order is ready to ship, StoreConnect can register the shipment with Australia Post and retrieve a tracking number.

Configure Australia Post as a shipping provider

To use Australia Post, you need API credentials from an Australia Post Developer Account. Follow the instructions for setting up a production key to obtain your Key, Secret, and Account Number.

Create a Shipping Provider record on your Store with the following values:

StoreConnect field Value
Provider Australia Post
API URL digitalapi.auspost.com.au
API Environment test or production (see below)
API Key Key (username) from Australia Post
API Secret Secret (password) from Australia Post
Account Your 10-digit Australia Post charge account number

API URL and environment

Set the API URL to digitalapi.auspost.com.au. Do not include a protocol (e.g. https://) or a path (e.g. /test) in this field.

:::warning StoreConnect automatically appends /test to the URL when the API Environment is not set to production. If you manually include /test in the API URL, the system will send requests to an invalid double path (/test/test) and no rates will be returned. :::

The API Environment field controls which Australia Post environment is used:

  • Set to test (or leave blank) when using test credentials
  • Set to production when you are ready to go live with real shipments

Confirm with your Australia Post account provider whether the credentials they gave you are for the test or production environment, and set this field accordingly.

Set product shipping dimensions

For Australia Post to return shipping rates at checkout, every product in the cart must have all of the following fields populated:

Field Example value
Shipping Weight 2
Shipping Weight Unit kilogram
Shipping Length 30
Shipping Width 20
Shipping Height 15
Shipping Dimensions Unit centimeter

:::warning If any single dimension or unit field is missing on any product in the cart, no shipping rates will be returned. There is no error message displayed to the customer — the shipping options will simply be blank. :::

Set Australia Post as a product shipping method

Each product that you want to ship via Australia Post must have Australia Post selected in the product’s Shipping Methods field.

If Australia Post does not appear in the field, a new picklist value needs to be added for it, with the API Name australia_post.

Without this, StoreConnect will not query Australia Post for rates on that product.

Get Product IDs for shipment registration

Your Australia Post account has Product IDs associated with it (e.g. eParcel services). You need these to register a shipment as ready for collection. To get the applicable product codes for your account, query the Australia Post API.

Go live (test to production)

To switch from test mode to production, you need to submit the Technical Validation Form to Australia Post. If you have Adobe Acrobat you can download and edit the form below:

You will need these JSON files for section 8 of the form:

Once approved, update the API Environment field on your Shipping Provider record to production.

Troubleshooting

If shipping rates are not appearing at checkout, check the following:

  1. API URL — Ensure the URL is digitalapi.auspost.com.au with no /test suffix and no https:// prefix
  2. API Environment — Confirm this matches the type of credentials you have (test or production)
  3. Product dimensions — Verify that every product in the cart has all six shipping fields populated (weight, weight unit, length, width, height, dimensions unit)
  4. Product shipping method — Confirm each product has Australia Post selected in its Shipping Methods field
  5. Stock Location — Ensure the Stock Location has a complete address including country and state ISO code

Use the Web Console on your storefront to inspect shipping API calls in real time. Open the Web Console, then attempt a checkout. You should see the outbound request to Australia Post and any error response. If no API call appears at all, the request was blocked before reaching Australia Post (typically due to missing product dimensions or shipping method configuration).

Was this article helpful?

Was this article helpful?