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
productionwhen 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:
- API URL — Ensure the URL is
digitalapi.auspost.com.auwith no/testsuffix and nohttps://prefix - API Environment — Confirm this matches the type of credentials you have (test or production)
- Product dimensions — Verify that every product in the cart has all six shipping fields populated (weight, weight unit, length, width, height, dimensions unit)
- Product shipping method — Confirm each product has
Australia Postselected in its Shipping Methods field - 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).