Integration With Sendcloud

Last Updated: February 4, 2024

ReturnGO integrates with Sendcloud to help you manage your return shipping. Sendcloud is a shipping aggregator that connects to 85+ systems and carriers. 

Capabilities 

The ReturnGO-Sendcloud integration supports:  

  • Pay-on-scan return labels 
  • Live tracking status updates 
    • For live tracking status updates, ReturnGO will provide a webhook listener URL which you can set in your Sendcloud account. 
  • International shipping labels (within Schengen only)
Return Labels Return Tracking QR Codes Auto Select Cheapest International Shipping

See a full feature comparison with other shipping carriers.

Updated API

The new API is currently available in beta. Contact support to enable.

ReturnGO has updated the API endpoints used in the Sendcloud integration, changing slightly how the integration functions. 

Features of the new API:

  • The return label can be either a printable return label or a QR code, not both.
  • If QR code generation fails, a printable label will automatically be generated instead.
  • International shipments are now fully supported, including outside of Schengen.
  • Instead of selecting a carrier/service level by name, you will now need to select a contract (as appears in your Sendcloud dashboard).
  • Service-level products will be selected automatically depending on the shipment parameters, such as from address, to address, dimensions, and weight.

Note: The current API is still supported, but will likely be phased out in the future.

Requirements 

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

Sendcloud Public and Secret API keys

To access your Sendcloud Public and Secret API keys: 

  1. Log in to Sendcloud. 
  2. Navigate to Settings > Integrations
  3. From the list of integrations, choose Sendcloud API > Learn More.
  4. Fill out the form. 
  5. Set the name to ReturnGO. 
  6. Enable Service Points to reveal your carrier options. Choose the carriers you want available in your ReturnGO integration. 
  7. Click SAVE. This will generate your Sendcloud Public and Secret API keys. 

When choosing a shipping carrier, make sure it’s configured to support return labels, otherwise, the shipping carrier may show up in your shipping account but will not be listed as a carrier option in ReturnGO. 

Linking Your Sendcloud Account to ReturnGO 

To link your Sendcloud account to ReturnGO: 

  1. Go to Integration > Products & Services
  2. Click on ADD PRODUCT OR SERVICE. 
  3. Choose Sendcloud 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
  2. Click SHIP WITH PRE-PAID LABEL
  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 Sendcloud


6. Select a contract.
7. Verify your return address and shipping instructions. 
8. Click on the save icon. 

Configuring Sendcloud Live Tracking Status Updates

Sendcloud supports automatic return label tracking updates. In your Sendcloud account, you must manually register for the tracking service.

To configure Sendcloud live tracking status updates: 

  1. Get a webhook URL from ReturnGO. 
  2. Go to Return Methods
  3. Choose the return method you have Sendcloud set up for. 
  4. Go to the Shipping Label Settings section. 
  5. Copy the webhook listener URL. 
  6. Add the webhook listener URL in Sendcloud. 
  7. Log in to Sendcloud
  8. Navigate to Settings > Integrations. 
  9. From the list of integrations, choose Sendcloud API > Edit. 
  10. Go to the Sendcloud API Settings page and check that Webhook Feedback is enabled. 
  11. Paste the webhook URL in the relevant field. 
  12. Click SAVE.

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 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 all 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. 

Sendcloud-Related Issues 

For Sendcloud-related issues, please contact Sendcloud Support. 

Other Issues

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