Shipping Aggregators
      Back to home
      1. Knowledge Base
      2. Shipping Integrations
      3. Shipping Aggregators

      Integration With Shippo

      Last Updated: October 13, 2024

      ReturnGO integrates with Shippo to help you manage your returns shipping. 

      Shippo is a shipping aggregator that connects you to a wide range of carriers for automating return shipping labels to save you time and money. 

      Capabilities

      The ReturnGO-Shippo integration supports: 

      • Pay-on-scan return labels 
      • QR code generation through supported carriers:
        • Evri - for both forward and return labels.
        • USPS - only for forward labels, and only for supported services. Unsupported modes will result in an error.
      • Live tracking status updates 
      • Auto-select-cheapest 
      Return Labels Return Tracking QR Codes Auto Select Cheapest International Shipping

      See a full feature comparison with other shipping carriers.

      Requirements

      To link your Shippo account to ReturnGO, you will need: 

      Shippo Account

      • Make sure you have a Shippo web app account.

      Shippo API token 

      Shippo API (Latest Version) 

      • Log in to Shippo > Settings > API to verify or upgrade your Shippo API version.
      • In some cases, using an older Shippo API version can prevent label creation. 

      131

      Valid Payment Method 

      When choosing a carrier, it should be configured to support return labels. 

      • Otherwise, the carrier may show up in your shipping account but will not be listed as a carrier option in ReturnGO.  

      Linking your Shippo Account to ReturnGO 

      To link your Shippo account to ReturnGO: 

      1. Go to Integration > Products & Services. 
      2. Click on ADD PRODUCT OR SERVICE. 
      3. Choose Shippo from the drop-down list. 
      4. Click on the green check mark.

      5. Enter your credentials.
      6. Click CONNECT. 

      Adding the Integration to a Return Method

      Once you've connected the integration, you'll need to add it to a return method:

      1. Go to Settings > Return Methods. 
      2. Open the Ship with pre-paid label section. 
      3. Click ADD RETURN METHOD or select a return method to edit.

      Add return method with label-png-3

      4. Open the Shipping Label Settings section.

      5. Set Connection to Shippo.

      6. Select a carrier/service level.


      7. Verify your return address and shipping instructions.

      8. Click on the save icon to save your changes.
      Return method settings-png-3

      Note: You can choose to disable the shipping address validation that Shippo performs when a shipment is created, by enabling the toggle under Return Methods > Shipping Label Settings.

      Troubleshooting the Integration

      Many of the issues encountered related to integration can be identified during setup or label generation. 

      Here are a few things you can check to try and fix such issues: 

      Setup Issues

      Make sure your API credentials are accurate. 

      • There should be no extra spaces before or after each API entry. 
      • Make sure you are using live or production API credentials, and not dev or test APIs. 
      • Try to re-generate a new API key and reconnect. 
      • If a carrier or service level is not available, contact your shipping service support team to verify which return services are available. 

      Note: Some carriers support forward deliveries only, returns only, or both.

      Label Creation Issues

      Verify your Return Address

      • Some carriers may not recognize special characters, which might cause issues when generating labels. 
      • Remove special characters and unnecessary spaces in your return address. 
        • For example: 
          • If your store name is “John & Jane Store”, change it to “John and Jane Store”. 
          • If your store phone number has “+” signs or “( )”, remove them. 

      Verify the Customer's Address 

      • ReturnGO takes the customer's address when the request is submitted. 
      • If there are corrections to the customer’s address, reject and resubmit the return request. 

      Verify the Item Weight 

      • If the total weight of the items being returned exceeds the service level’s weight limit, then the carrier will reject the label request. 

      Verify if you can Generate a Return Label for the Order Directly in the Shipping Platform

      • If your shipping service platform cannot generate the label, then it will also fail in ReturnGO. 

      Shippo-Related Issues 

      For Shippo-related issues, please contact Shippo support. 

      Other Issues 

      For any other issues, feel free to contact ReturnGO Support through chat or email.