Connect Carriers
Set up carrier integrations to generate shipping labels and track returns.
ReturnMate integrates with major Australian carriers to automate label generation and tracking. This guide covers setting up each supported carrier.
Supported Carriers
| Carrier | Label Types | Tracking | Collection Booking |
|---|---|---|---|
| Australia Post | Parcel Post, Express | ✓ | ✓ |
| StarTrack | Premium, Express | ✓ | ✓ |
| TNT | Road 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)
Contact each carrier directly to set up commercial shipping accounts. ReturnMate can provide introductions to carrier representatives if needed.
Australia Post
Getting API Credentials
- Log in to your Australia Post eParcel account
- Navigate to Settings → API Access
- Generate API credentials if not already created
- Copy your API Key and API Secret
Configuration in ReturnMate
- Go to Settings → Carriers
- Click Add Carrier and select Australia Post
- Enter your credentials:
| Field | Description |
|---|---|
| Account Number | Your AusPost account number |
| API Key | Your API authentication key |
| API Secret | Your API secret key |
| Environment | Production or Sandbox |
- Click Test Connection to verify
- 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
StarTrack
Getting API Credentials
- Contact your StarTrack account manager
- Request API access for your account
- Receive your API credentials via secure email
Configuration in ReturnMate
- Go to Settings → Carriers
- Click Add Carrier and select StarTrack
- Enter your credentials:
| Field | Description |
|---|---|
| Account Number | StarTrack account number |
| API Key | Authentication key |
| API Secret | Secret key |
| Environment | Production or Test |
- 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
- Go to Settings → Carriers
- Click Add Carrier and select TNT
- Enter your credentials:
| Field | Description |
|---|---|
| Account Number | TNT/FedEx account |
| Username | API username |
| Password | API password |
| Environment | Production/Test |
Services
- Road Express - Ground freight
- Overnight Express - Next business day
- Sensitive Express - Fragile/high-value items
TGE (Team Global Express)
Getting Credentials
- Contact your TGE account representative
- Request API access and credentials
- You'll receive a customer ID and authentication details
Configuration
- Go to Settings → Carriers
- Click Add Carrier and select TGE
- Enter your credentials:
| Field | Description |
|---|---|
| Customer ID | Your TGE customer identifier |
| API Key | Authentication key |
| Certificate | Digital 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:
- Click Test Connection on the carrier settings
- Verify you receive a success message
- 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:
- Go to Settings → Carriers → Defaults
- 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:
| Carrier | Max Weight | Max Length | Max Girth |
|---|---|---|---|
| Australia Post | 22kg | 105cm | 140cm |
| StarTrack | 32kg | 120cm | 250cm |
| TNT | 70kg | 180cm | 300cm |
| TGE | 50kg | 150cm | 300cm |
Surcharges
Be aware of potential surcharges:
- Remote/regional delivery fees
- Oversized package charges
- Fuel surcharges
- Residential delivery fees
Troubleshooting
Connection Test Fails
- Verify credentials are entered correctly
- Check for typos in account numbers
- Ensure API access is enabled on carrier side
- 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.