Namshi Webhook Integration Guide#
Overview#
This document outlines the seller onboarding process and workflow for integrating with Namshi’s webhook system. Webhooks enable real-time order status updates, ensuring seamless synchronization between Namshi and the seller’s system.What are Webhooks?#
Webhooks are automated notifications sent from Namshi’s platform to the seller’s server whenever specific events occur.
Instead of continuously polling our system for updates, sellers receive instant notifications, allowing them to take immediate action.Supported Events#
Currently, we support the following event:order_update – Triggered when:Webhook Workflow#
1. Event Trigger#
When an order is confirmed, canceled, or an exchange is created, our system verifies if a webhook is registered for the seller’s partner ID and the corresponding event type.
2. Webhook Event Creation#
If a webhook is registered, a webhook event is generated and stored in our system.
This event includes the order_nr (Order 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 the order_nr.
Example Request Body:#
{
"order_nr": "NMAEC3C57LPHV8MT"
}
4. Seller Action#
The seller’s server receives the HTTP POST request.
Fetch updated order details
Refresh or create the order
Update stock in their system
Modified at 2025-03-17 10:21:24
