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

Log into the Synctrack Return app.
Navigate to Settings > Webhooks.
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": "datdh@omegatheme.com",
        "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
      }
    }

Updated on: 02/06/2025