RM

Connect Carriers

Set up carrier integrations to generate shipping labels and track returns.

5 min read
Last updated 31 December 2024

ReturnMate integrates with major Australian carriers to automate label generation and tracking. This guide covers setting up each supported carrier.

Supported Carriers

CarrierLabel TypesTrackingCollection Booking
Australia PostParcel Post, Express
StarTrackPremium, Express
TNTRoad Express, Overnight
TGE (Team Global Express)Various

Before You Begin

You'll need from your carrier:

  • Account Number - Your carrier account ID
  • API Key/Username - Authentication credentials
  • API Secret/Password - Secret key for API access
  • Contract/Service codes (if applicable)
Don't Have Carrier Accounts?

Contact each carrier directly to set up commercial shipping accounts. ReturnMate can provide introductions to carrier representatives if needed.

Australia Post

Getting API Credentials

  1. Log in to your Australia Post eParcel account
  2. Navigate to Settings → API Access
  3. Generate API credentials if not already created
  4. Copy your API Key and API Secret

Configuration in ReturnMate

  1. Go to Settings → Carriers
  2. Click Add Carrier and select Australia Post
  3. Enter your credentials:
FieldDescription
Account NumberYour AusPost account number
API KeyYour API authentication key
API SecretYour API secret key
EnvironmentProduction or Sandbox
  1. Click Test Connection to verify
  2. Save your configuration

Selecting Services

Configure which Australia Post services to use:

  • Parcel Post - Standard delivery (2-6 business days)
  • Express Post - Priority delivery (next business day metro)
  • eParcel - Contract rates for high volume
📷
Australia Post Carrier Setup
(Screenshot placeholder)
Australia Post carrier configuration screen

StarTrack

Getting API Credentials

  1. Contact your StarTrack account manager
  2. Request API access for your account
  3. Receive your API credentials via secure email

Configuration in ReturnMate

  1. Go to Settings → Carriers
  2. Click Add Carrier and select StarTrack
  3. Enter your credentials:
FieldDescription
Account NumberStarTrack account number
API KeyAuthentication key
API SecretSecret key
EnvironmentProduction or Test
  1. Test and save your connection

Services

  • Premium - Standard road service
  • Express - Air freight for time-critical
  • Fixed Price - Contract negotiated rates

TNT (FedEx)

TNT is now part of FedEx. New accounts should be created through FedEx, though existing TNT integrations continue to work.

Configuration

  1. Go to Settings → Carriers
  2. Click Add Carrier and select TNT
  3. Enter your credentials:
FieldDescription
Account NumberTNT/FedEx account
UsernameAPI username
PasswordAPI password
EnvironmentProduction/Test

Services

  • Road Express - Ground freight
  • Overnight Express - Next business day
  • Sensitive Express - Fragile/high-value items

TGE (Team Global Express)

Getting Credentials

  1. Contact your TGE account representative
  2. Request API access and credentials
  3. You'll receive a customer ID and authentication details

Configuration

  1. Go to Settings → Carriers
  2. Click Add Carrier and select TGE
  3. Enter your credentials:
FieldDescription
Customer IDYour TGE customer identifier
API KeyAuthentication key
CertificateDigital certificate (if required)

TGE integration may require additional setup for certificate-based authentication. Contact support if you need assistance.

Testing Your Connection

After adding a carrier:

  1. Click Test Connection on the carrier settings
  2. Verify you receive a success message
  3. Generate a test label to confirm full functionality

Test Mode

Use sandbox/test environments during initial setup:

  • Labels are free in test mode
  • Tracking numbers are simulated
  • No actual shipments are created

Switch to Production when ready to process real returns.

Default Carrier Settings

Configure your default carrier preferences:

  1. Go to Settings → Carriers → Defaults
  2. Set:
    • Default Carrier - Used when no specific carrier is selected
    • Fallback Carrier - Used if primary is unavailable
    • Service Level Mapping - Match return reasons to service levels

Carrier-Specific Requirements

Package Limits

Each carrier has size and weight restrictions:

CarrierMax WeightMax LengthMax Girth
Australia Post22kg105cm140cm
StarTrack32kg120cm250cm
TNT70kg180cm300cm
TGE50kg150cm300cm

Surcharges

Be aware of potential surcharges:

  • Remote/regional delivery fees
  • Oversized package charges
  • Fuel surcharges
  • Residential delivery fees

Troubleshooting

Connection Test Fails

  1. Verify credentials are entered correctly
  2. Check for typos in account numbers
  3. Ensure API access is enabled on carrier side
  4. Confirm you're using correct environment (test/prod)

Label Generation Errors

Common causes:

  • Invalid destination address
  • Package exceeds size limits
  • Account not authorised for service type
  • Rate limit exceeded

See Tracking & Label Issues for more help.

Was this helpful?
Contact Support