> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.theconvertway.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Eco Return Integration

This integration enables automated WhatsApp notifications for key return events—Return Requested, Pickup Created, and Refund Issued—offering customers real-time updates throughout the return process.

Steps to do the integraiton:-
Install the Eco return app from shopify playstore, then go to Settings>> Developers tool>> "Create Webhook"
![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/8/6/bc86d77513590800/image_uptetg.png)
In new webhook, fill up the details & save.
* In Payload url, enter the Convertway Endpoint " [https://convert.shipway.com/dashboard/hooks/ecoreturns.php](https://convert.shipway.com/dashboard/hooks/ecoreturns.php) "
* In Auth Header Key (mandatory), Enter "licence-key" 
* In Auth Header Value (mandatory) , Enter "key-value" ( Step to Check licence-key in convertway - > settings>profile>licence key )
* In events- select the needed events from the mentioned three "Return request, Pickup created & Refund Issued" 
![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/8/6/bc86d77513590800/image_tmonmg.png)

* Configuration is successful on ECOreturn platform. Now just active  the integration status in the Convertway.
* After activation the new trigger "Ecoretrun Integration" will be shown in the "custom flow".

**IMPORTANT Guildeline for creating Custom Fows with ( EcoReturn Integration Trigger):-**
* Create a new custom flow and setup the respective "Eco return" event and save the custom flow.
* ![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/8/6/bc86d77513590800/image_15f1efj.png)

* **Info** ** :-** In Custom Flows powered by EcoReturn events, only whatsapp templates created under the "Ecoreturn Event" will be displayed.
Steps to create template for "Ecoreturn event" :-
Templates--> "whatsapp template --> Ecoretrun Integration {category} ---> Ecoreturn Events {Subcategory} 
![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/8/6/bc86d77513590800/image_4n7ao4.png)
Here, for template creation, all fetched variables from the Ecoretrurn Payload are displayed.
**Important:** Use only the variables mapped to the specific event while creating templates. Using unmapped variables may cause message failures if values are missing during sending.
Example: If you're creating a template for "Return Requested", use only its mapped variables.

**Event-to-Variable Mapping:**
✅ **Return Requested**: {customer_name}
, {store_name}, {event}
, {item_cost}
, {new_item_quantity}
, {order_id}
, {product_name}
, {quantity}
, {request_type}
, {reverse_shipment_fee_paid}
, {status}
, {customer_address}
✅ **Pickup Created**: {customer_name}
, {store_name}
, {status}
, {item_cost}
, {order_id}
, {product_name}
, {quantity}
, {request_type}
, {courier}
, {customer_address}
✅ **Refund Issued**: {customer_name}
, {store_name}
, {event}
, {item_cost}
, {order_id}
, {payout_link}
, {product_name}
, {quantity}
, {recipient}
, {refund_amount}
, {refund_to}
, {request_type}
, {status}
, {store_credit_type}