Integration With Shippo

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

Shippo is a shipping solution that automates and streamlines your return process to save you time and money. 


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.


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

Shippo API token 

Shippo API (Latest Version) 

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

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
  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 Return Methods
  3. Click ADD RETURN METHOD or select a return method to edit.

Add return method with label-png-3

4. Go to 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. 
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.