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