Namshi Webhook Integration Guide – Return Picked Up

Overview

This document outlines the workflow and seller integration process for the return_picked_up webhook event.
The webhook ensures real-time synchronization between Namshi and the seller’s system when a return order is successfully collected from the customer.

What is the `return_picked_up` Event?

The return_picked_up webhook is triggered when a courier has successfully picked up a return package from the customer.
This allows sellers to:

Track the status of return shipments

Reconcile stock in their system

Supported Event

return_picked_up – Triggered when:

A return item(s) has been successfully picked up by the DA from the customer.

Webhook Workflow

1. Event Trigger

When a DA confirms the pickup of a return, our system verifies if a webhook is registered for the seller’s partner ID and the corresponding return_picked_up event.

2. Webhook Event Creation

If a webhook is registered, a webhook event is generated and stored in our system.

This event includes the return_nr (Return Number) and the awb_nr (Air Waybill Number).

3. Webhook Notification (HTTP POST Request)

Our system sends an HTTP POST request to the webhook URL provided during registration.

The request body contains a JSON payload with return and shipment details.

Example Request Body:

{
  "return_nr": "NMAEC54YT3IGFJUP-8-P1-R1",
  "awb_nr": "PCB0097147906A"
}

Return Picked Up Webhook

Namshi Webhook Integration Guide – Return Picked Up#

Overview#

What is the return_picked_up Event?#

Supported Event#

Webhook Workflow#

1. Event Trigger#

2. Webhook Event Creation#

3. Webhook Notification (HTTP POST Request)#

Example Request Body:#