Set up shipping carriers & account integration

Enable Prepaid Label Feature

Before connecting any logistics carriers, you must first enable the Ship Prepaid Label option in your settings.

1. 1Navigate to "Settings" in your Returndotai dashboard
2. 2Select "Return/Exchange Flow" from the settings menu
3. 3Find the "Return Method" section
4. 4Locate "Ship Prepaid Label" option
5. 5Toggle the switch to ENABLED
6. 6Save your changes

• This setting makes the prepaid label option available to customers on the return portal
• Without enabling this, customers won't see the prepaid label shipping method
• You can disable this at any time if you want to temporarily stop offering prepaid labels

Add Warehouse Address

Your warehouse address is where customers will ship their returns. This address must be configured correctly for label generation to work.

1. 1In Settings, navigate to the Warehouse Address section
2. 2You have two options to add your warehouse address:
3. 3 • Click "Sync from Shopify" to automatically import your Shopify store address
4. 4 • Click "Create new" to add warehouse address manually
5. 5Choose the method that works best for your setup

Option 1: Sync from Shopify (Recommended)

For Shopify stores, syncing is the easiest and most accurate method.

1. 1Click "Sync from Shopify" button
2. 2System will automatically fetch your store's address from Shopify
3. 3Review the imported address details
4. 4Verify all fields are correct
5. 5Click "Save" to confirm

• This method reduces manual entry errors
• Address is automatically formatted correctly
• Synced address stays consistent with your Shopify store

Option 2: Create New (Manual Entry)

For non-Shopify stores or custom warehouse locations, you can manually enter the address.

1. 1Click "Create new" button
2. 2Fill in all required address fields carefully
3. 3Ensure exact accuracy in every field
4. 4Click "Save" to add the warehouse address

⚠️ Critical: Ensure Exact Address Matching

Ensure that all fields of this address exactly match the address in your logistics carrier account. This is the most common cause of label generation errors.

• ✓ Company name - Must match exactly, including capitalization
• ✓ Street address (line 1 and line 2 if applicable) - No abbreviations unless carrier uses them
• ✓ City - Exact spelling and capitalization
• ✓ State/Province - Use correct format (full name vs abbreviation)
• ✓ Postal/ZIP code - Exact match, including format (e.g., 12345 vs 12345-6789)
• ✓ Country - Use same country code format as carrier
• ✓ Phone number - Include country code if carrier requires it

Navigate to Logistics Settings

Connect your logistics carrier accounts to enable automatic label generation.

1. 1Go back to "Settings" in your dashboard
2. 2Look for and select "Logistics" in the left menu
3. 3You'll see a list of available carrier integrations

Choose Your Carrier

Select the carrier you want to integrate from the available options.

• Popular carriers available:
• • FedEx - North American and international shipping
• • Australia Post - Australian domestic and international
• • EasyPost - Multi-carrier aggregator for US shipping
• • Shiprocket - Indian domestic and international logistics
• • Shippo - Multi-carrier shipping platform
• • ShipStation - Multi-carrier management platform
• • Shipway - Multi-carrier shipping for India
• • Sendcloud - European multi-carrier platform
• • Delhivery - Indian logistics provider
• • iThink Logistics - Indian shipping solution
• Click "Connect" or "Set up" button next to your chosen carrier

Enter Carrier Credentials

Follow the prompts to enter your account credentials for the selected carrier.

1. 1A form will appear requesting your carrier API credentials
2. 2Enter the required information (API Key, Secret Key, Account Number, etc.)
3. 3Refer to the carrier-specific documentation for obtaining these credentials:
4. 4 • ShipStation: Public API Key + API Secret
5. 5 • Shipway: Email + License Key
6. 6 • Sendcloud: Public Key + Secret Key
7. 7 • FedEx: Account Number + Meter Number + API credentials
8. 8 • EasyPost/Shippo: API Key
9. 9Double-check that all credentials are entered correctly
10. 10Click "Connect" or "Save" to establish the connection

Verify Successful Connection

After entering credentials, the system will verify your connection.

• Green checkmark or "Connected" status indicates success
• If connection fails, double-check your credentials
• Ensure your carrier account is active and in good standing
• Verify you have API access enabled in your carrier account
• Some carriers require you to enable API access in their dashboard first

Test the Integration

After successful connection, test label generation with a sample return.

1. 1Create a test return request in your dashboard
2. 2Approve the return request
3. 3Select your newly connected carrier
4. 4Choose package size and service level
5. 5Click "Generate Label"
6. 6Verify the label is created successfully
7. 7Check that tracking number is generated
8. 8Download and review the label PDF

Common Error: Address Matching Issues

If you receive errors when trying to create a label for a return request, first check the address matching:

1. 1Compare each field of the address in Returndotai system with your carrier account
2. 2Look for any differences in:
3. 3 • Spelling variations
4. 4 • Punctuation (periods, commas, hyphens)
5. 5 • Formatting (abbreviations vs full names)
6. 6 • Capitalization
7. 7 • Extra spaces
8. 8Update any mismatched fields in Returndotai to exactly match your carrier account
9. 9Save the updated address
10. 10Try generating the label again

Issue: Connection Failed

Key points to understand:

• Problem: "Invalid credentials" or "Connection failed" error
• Solutions:
• 1. Verify API credentials are copied correctly (no extra spaces)
• 2. Check that API access is enabled in your carrier account
• 3. Ensure carrier account is active and in good standing
• 4. For test/sandbox accounts, make sure you're using test credentials
• 5. Regenerate API credentials in carrier dashboard and try again
• 6. Contact carrier support to verify API access is enabled

Issue: Label Generation Failed

Key points to understand:

• Problem: Connection successful but label generation fails
• Solutions:
• 1. Verify warehouse address matches carrier account exactly
• 2. Check that carrier account has sufficient funds/credit
• 3. Ensure package dimensions and weight are within carrier limits
• 4. Verify destination address is valid and serviceable
• 5. Check if carrier supports the selected service level for this route
• 6. Review carrier-specific requirements (e.g., required customs forms for international)

Issue: No Tracking Number

Key points to understand:

• Problem: Label created but no tracking number appears
• Solutions:
• 1. Wait 1-2 minutes and refresh - tracking may appear with delay
• 2. Check carrier dashboard to verify shipment was created
• 3. Download label PDF and check if tracking number is printed on label
• 4. If tracking is on label but not in system, contact support

Address Management Best Practices

Use "Sync from Shopify" whenever possible to reduce errors

• Double-check address accuracy before connecting carriers
• Keep a reference copy of your carrier account address for comparison
• Test label generation immediately after setup to catch issues early
• Document any carrier-specific formatting requirements
• Set up address validation rules if your carrier supports them

Carrier Connection Tips

Connect carriers during business hours in case you need support

• Start with one carrier and verify it works before adding more
• Keep carrier API credentials in a secure password manager
• Test with sandbox/test accounts before using production credentials
• Monitor first few label generations closely after setup
• Set up notification alerts for failed label generation attempts

Ongoing Maintenance

Regularly verify address consistency between systems

• Update addresses in both systems simultaneously if you move
• Monitor carrier account status and credit balance
• Review failed label attempts weekly to identify recurring issues
• Keep API credentials up to date (some carriers require periodic rotation)
• Test integrations after any carrier account changes

Critical Reminders

⚠️ Exact address matching is critical - Even minor discrepancies can cause label creation errors

• 🔄 Regularly verify that your address information remains consistent between Returndotai and your carrier account
• 📝 If you update your address with the carrier, remember to update it in Returndotai as well
• 📋 Some carriers may have specific formatting requirements for addresses - Ensure you follow these in both systems
• 🔒 Keep your API credentials secure and never share them publicly
• ✅ Test the integration thoroughly before enabling for customers
• 📊 Monitor label generation success rates in your dashboard