Integrating Your Return Portal to Your WooCommerce Store

Last Updated: December 8, 2024

ReturnGO seamlessly integrates with WooCommerce to provide a comprehensive return management solution.

Capabilities

The features supported include:

  • Order-level refunds to payment method 

  • Variant exchanges

    • ReturnGO creates draft exchange orders in Pending status, and when the exchange is released, the order status changes to Completed to indicate that it has been paid and can now be fulfilled.

    • Exchanges to even, more, and less expensive variants. Exchanges to more expensive variants require a Stripe integration.

  • Product exchanges

    • ReturnGO creates draft exchange orders in Pending status, and when the exchange is released, the order status changes to Completed to indicate that it has been paid and can now be fulfilled.

    • Exchanges to even, more, and less expensive products. Exchanges to more expensive products require a Stripe integration.

    • Only one-for-one exchanges are supported.

  • Portal checkout

    • Portal checkout can be used with Stripe for customers to pay for fees and exchange price differences directly in the portal.

How to Integrate ReturnGO with WooCommerce

To set up your ReturnGO return portal with WooCommerce, you’ll need to create an API key and share it with the ReturnGO team, who will implement the integration for you.

Requirements

To integrate ReturnGO with WooCommerce, you'll need the following credentials:

  • WooCommerce server URL
  • Owner email
  • Full store address and phone number
  • Consumer key
  • Consumer secret

Getting Credentials

To obtain the necessary credentials for integrating ReturnGO with WooCommerce:

  1. Go to WooCommerce > Settings.

  2. Click on ADVANCED.

    Woo1
  3. Click on REST API.

  4. Click on ADD KEY or CREATE AN API KEY.

    Woo2
  5. Give the API a name for internal identification, i.e “ReturnGO”.

  6. Set the permissions to Read/Write.

  7. Click GENERATE API KEY.


    Woo3
  8. Copy the Consumer key.

  9. Copy the Consumer secret.

    Woo4

Share these credentials as well as your server URL, owner email, full store address, and store phone number with the ReturnGO team, who will implement the integration for you.

Adding Your ReturnGO Portal to a Page

After you are connected to ReturnGO, you will need to add the return portal script to one of your website pages, where you want the portal to appear.

To add your return portal to a WooCommerce page:

1. Add the following to the page HEAD section of the page where you want the portal to appear:

<script src="https://static.returngo.ai/master.returngo.ai/returngo.min.js" defer="defer"></script>
<script type="application/javascript">
   window.ReturnGO = {
     shop: 'shopname.com', //Your shop URL
       locale: 'en', //The locale to display
   };
</script>

To find your shop URL, click on the "copy" icon next to your store name at the top of the ReturnGO dashboard. This will copy your shop URL (which is not visible) to your clipboard.

shop_url-png-12. Add this code to the page BODY section of the page where you want the portal to appear:

<div id="ReturngoPortalEmbedding" style="position: relative; display:block; min-height: 600px; ></div>

Read more about portal embedding and customization here.