Returns/Exchanges Webhooks

Introduction

The Returns/Exchange Webhooks feature enables merchants to integrate and synchronize return/exchange data with their systems in real-time. This guide will walk you through the setup process, key benefits, and considerations for using this feature.

Merchant Setup

Activating the Feature

1. Log into the Synctrack Return app.
2. Navigate to Settings > Webhooks.
3. Create webhook with endpoint and optional topics

Configuring the Webhooks

By default, webhooks are available for the following events:

• Return/Exchange Order Created
• Approved
• Rejected
• Refunded

You can select which events to create for webhook notifications.

You can also test the received data by sending a test webhook.

Response

{
      "topic": "RETURNS_CREATE",
      "returnOrderId": "RF11ADEDB8",
      "requestDate": "2025-03-05T04:08:47.522Z",
      "status": "PENDING",
      "returnMethod": "Ship with any carrier",
      "returnFee": "15.00",
      "orderId": "#1036",
      "currency": "USD",
      "customer": {
        "id": "7856547070120",
        "name": "null null",
        "email": "[email protected]",
        "address": ""
      },
      "shippingAddress": {
        "name": null,
        "address": null,
        "address2": null,
        "city": null,
        "province": null,
        "provinceCode": null,
        "country": null,
        "countryCode": null
      },
      "items": [
        {
          "productName": "Refuge Destroyed Super Shortie Denim Shorts",
          "reason": "Others (Please specify in additional notes)",
          "price": "15.0",
          "quantity": 1
        }
      ],
      "label": {
        "url": null
      }
    }