How to connect with Australia Post

Article on: Returndotai
Updated on: 01/14/2026

Introduction

This guide will walk you through the process of connecting your account to Australia Post for seamless return label generation. Australia Post eParcel integration enables you to create prepaid return labels for your Australian customers.

Access this feature

Navigate to /settings/logistic in your application.

Step 1: Obtain Your API Key

Register at Australia Post Developer Centre

To connect with Australia Post, you'll need to obtain an API key. Follow these steps:

  1. 1Firstly, you need to register at the Australia Post Developer Centre
  2. 2Visit: https://developers.auspost.com.au/
  3. 3Create a new developer account or login if you already have one

Australia Post Developer Centre

Screenshot showing Australia Post Developer Centre registration page

IMPORTANT: Registration Requirements

When registering, you must follow these specific requirements:

  1. 1a. Choose "Australia Post eParcel accounts" (Returndotai – AusPost integration only supports eParcel account's API. For other services, please contact us)
  2. 2b. Select "Other" when asked about their platform partner (view picture below)
  3. 3c. Enter "OmegaTheme" or "Returndotai Returns" as their preferred provider

Registration Requirements

Screenshot showing platform partner selection with "Other" option and preferred provider field

Complete Registration

  1. 1Complete the rest of the form with your business details
  2. 2Include your business name, address, and contact information
  3. 3Submit the request for review
  4. 4Australia Post will review your request and provide you with a production API Key
  5. 5This review process may take a few business days

Complete Registration Form

Screenshot showing completed Australia Post registration form

Step 2: Connect Your Account

Connect Australia Post to Returndotai

Once you have your API Key:

  1. 1Log in to your Returndotai Returns dashboard
  2. 2Navigate to the "Settings" section > "Logistics" tab
  3. 3Look for the Australia Post integration option and click "Connect" or "Set up"
  4. 4You'll be prompted to enter your API Key. Paste the key you received from Australia Post into this field
  5. 5Click "Connect" to establish the connection

Connect Australia Post

Screenshot showing Settings > Logistics > Australia Post with API Key input field

Step 3: Configure Settings

Configure Package Settings

After connecting:

  1. 1Set your default package sizes and types
  2. 2Make sure method "Ship with pre-paid label" is enabled

Configure Settings

Screenshot showing package settings and Ship with pre-paid label toggle

Step 4: Test the Connection

Create Test Return Request

Before going live:

  1. 1Create a test return request on return page
  2. 2Choose "Ship pre-paid label" for return method
  3. 3Note: This method is only displayed on return page if you enable it in the app as mentioned in Step 3

Create Test Request

Screenshot showing return page with Ship pre-paid label option

Submit and Verify Label

  1. 1Submit the test return request
  2. 2Go into the app, open this request at "Return management" tab
  3. 3Click to approve the request
  4. 4Select the appropriate shipping carrier if prompted
  5. 5Verify that the label is created correctly and contains accurate information

Verify Australia Post Label

Screenshot showing approved return with generated Australia Post label

Additional Resources

For more detailed information on creating and printing return labels, refer to our comprehensive guide on label generation and management.

Additional Resources

Link to How to create and print return labels documentation

Troubleshooting

Common Issues and Solutions

If you encounter any issues, try these troubleshooting steps:

  1. 1If you encounter any issues with label generation, double-check your API key and connection settings
  2. 2Ensure your account has sufficient balance for label creation if applicable
  3. 3Verify that you selected "eParcel accounts" during registration
  4. 4Confirm that you entered "OmegaTheme" or "Returndotai Returns" as the preferred provider
  5. 5Check that your package dimensions and weight are within Australia Post limits

Troubleshooting Steps

Screenshot showing common error messages and solutions

Contact Support

For any persistent issues:

  • Contact Australia Post developer support at https://developers.auspost.com.au/support
  • Contact our customer service team for integration assistance
  • Provide your API key (last 4 characters only) and error details when seeking help

Contact Support

Screenshot showing support contact information

Key Features

eParcel Integration

Full integration with Australia Post eParcel for domestic and international shipping

National Coverage

Access Australia Post's extensive national delivery network across Australia

Automated Label Generation

Automatically create prepaid return labels for approved return requests

Multiple Service Levels

Choose from various service levels including standard, express, and tracked options

Tracking and Insurance

Built-in tracking capabilities and optional insurance for valuable items

Developer Support

Access to Australia Post Developer Centre for API documentation and support

Important Notes

eParcel Accounts Only

Returndotai integration only supports Australia Post eParcel account's API. For other Australia Post services, please contact our support team.

Use Correct Provider Name

When registering, you must enter "OmegaTheme" or "Returndotai Returns" as your preferred provider. This ensures smooth integration with our system.

Select "Other" as Platform Partner

During registration, make sure to select "Other" when asked about platform partner, not any specific eCommerce platform.

Review Process Takes Time

Australia Post will review your API request. This may take a few business days, so plan your integration timeline accordingly.

Check Account Balance

Ensure your Australia Post account has sufficient balance for label creation. Low balance can cause label generation failures.

Test Before Going Live

Always create a test return request and verify that labels are generated correctly before enabling the integration for customers.

Related Articles

Was this article helpful?

Quick Links

Related Categories

Support

Need help? Contact our support team

support@returndotai.com

© 2025 Returndotai. All rights reserved.
Returndotai | Shopify Returns Management & Exchange Platform