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"
In new webhook, fill up the details & save.
- In Payload url, enter the Convertway Endpoint " 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"
- 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.
- 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}
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}
Updated on: 29/07/2025
Thank you!