order.customer.updated
Triggered when the customer on an order is updated.
يُرسل عند تعديل بيانات العميل في الطلب.
| Platform | Salla |
| Group | Order |
| Payload model | Orders Webhook Events Model (shared with order.created, order.updated, order.cancelled, order.refunded, order.deleted, order.products.updated, order.payment.updated, order.coupon.updated, order.total.price.updated, order.shipping.address.updated) |
| JSON Schema | schemas/salla/order.customer.updated.schema.json |
| Official docs | docs.salla.dev/webhook-events/orders |
Note
Listed in the event enum of Salla's order schema but not in the main events table.
Example payload
Salla publishes one example for this payload model, shown here for order.created. order.customer.updated uses the same structure.
json
{
"event": "order.created",
"merchant": 1305146709,
"created_at": "Sun Jun 26 2022 12:21:48 GMT+0300",
"data": {
"id": 2116149737,
"reference_id": 41027662,
"urls": {
"type": "object",
"properties": {
"customer": {
"type": "string",
"examples": [
"https://shtara.com/profile"
],
"description": "Customer Link directly to the order."
},
"admin": {
"type": "string",
"examples": [
"https://shtara.com/profile"
],
"description": "Admin Dashboard Link directly to the order."
},
"digital_content": {
"type": "string",
"description": "Returns a direct link to the associated digital content. This can be used to retrieve files such as e-books, images, PDFs, videos, or any downloadable digital asset linked to the order or product."
}
},
"x-apidog-orders": [
"customer",
"admin",
"digital_content"
],
"required": [
"digital_content"
]
},
"date": {
"date": "2022-06-26 12:21:45.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"source": "store",
"source_device": "desktop",
"source_details": {
"type": "direct",
"value": null,
"device": "desktop",
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Safari/537.36",
"ip": "31.166.186.78"
},
"first_complete_at": null,
"status": {
"id": 566146469,
"name": "بإنتظار المراجعة",
"slug": "under_review",
"customized": {
"id": 986688842,
"name": "بإنتظار المراجعة"
}
},
"payment_method": "bank",
"currency": "SAR",
"amounts": {
"sub_total": {
"amount": 186,
"currency": "SAR"
},
"shipping_cost": {
"amount": 15,
"currency": "SAR"
},
"cash_on_delivery": {
"amount": 0,
"currency": "SAR"
},
"tax": {
"percent": "0.00",
"amount": {
"amount": 0,
"currency": "SAR"
}
},
"discounts": [
{
"title": "new offer",
"type": "special",
"code": "new offer",
"discount": "5.00",
"discounted_shipping": 0
}
],
"total": {
"amount": 196,
"currency": "SAR"
}
},
"shipping": {
"id": 1833934431,
"app_id": null,
"company": "السعودية",
"logo": "",
"receiver": {
"name": "Mohammed Ali",
"email": "usertest@gmail.com",
"phone": "999123456789"
},
"shipper": {
"name": "Demo",
"company_name": "dev-wofftr4xsra5xtlv",
"email": "wofftr4xsra5xtlv@email.partners",
"phone": "966500000000"
},
"pickup_address": {
"country": "السعودية",
"country_code": "SA",
"city": "مكة",
"shipping_address": "شارع عبدالله,السلام,23233, سنابل السلام, مكة,السعودية",
"street_number": "شارع عبدالله",
"block": "السلام",
"postal_code": "23233",
"geo_coordinates": {
"lat": 21.3825905096851,
"lng": 39.77319103068542
}
},
"address": {
"country": "SA",
"country_code": "SA",
"city": "جدة",
"shipping_address": " شارع ابو امية الضمري، الحي الزهراء ،, جدة, السعودية",
"street_number": "ابو امية الضمري",
"block": "الزهراء",
"postal_code": "",
"geo_coordinates": {
"lat": 0,
"lng": 0
}
},
"shipment": {
"id": "0",
"pickup_id": null,
"tracking_link": "0",
"label": []
},
"policy_options": []
},
"shipments": [
{
"id": 649964784,
"created_at": null,
"type": "shipment",
"courier_id": 802226618,
"courier_name": "أوتو",
"courier_logo": "https://salla-dev-portal.s3.eu-central-1.amazonaws.com/uploads/LUZaDEGwzFRDJKO7XVLXtix71Zb8Z2vBt6xwHrwZ.png",
"shipping_number": null,
"tracking_number": null,
"pickup_id": null,
"trackable": false,
"tracking_link": null,
"label": null,
"payment_method": "cod",
"source": "store",
"status": "in_progress",
"total": {
"amount": 175.47,
"currency": "SAR"
},
"cash_on_delivery": {
"amount": 0,
"currency": "SAR"
},
"is_international": true,
"total_weight": {
"value": 0.2,
"units": "kg"
},
"packages": [
{
"item_id": 2077288690,
"external_id": null,
"quantity": 1,
"weight": {
"value": 0.2,
"units": "kg"
}
}
],
"ship_from": {
"type": "branch",
"name": "المستودع الرئيسي التجريبي",
"email": "",
"phone": "966555855555",
"country": "السعودية",
"city": "Medina",
"address_line": "3391 حسين بين عبدلله بين ضميرا,مسجد الدرع,00000, 3391 حسين بين عبدلله بين ضميرا, الدرق موثق, مدينة 42313 8700, سعودي عربية, Medina,السعودية",
"street_number": "3391 حسين بين عبدلله بين ضميرا",
"block": "مسجد الدرع",
"postal_code": "00000",
"latitude": 24.524655575978006,
"longitude": 39.56918120384216,
"branch_id": 1790435930
},
"ship_to": {
"type": "address",
"name": "Test Username",
"email": "user@gmail.com",
"phone": "971501960991",
"country": "الامارات",
"city": "أبو ظبي",
"address_line": " شارع ijaz street، الحي Shakhbout city 70633،, villa 24,, أبو ظبي, الامارات",
"street_number": "ijaz street",
"block": "Shakhbout city",
"postal_code": "70633",
"latitude": 0,
"longitude": 0
},
"meta": {
"app_id": 846904320,
"policy_options": {
"dimensions": {
"length": "",
"width": "",
"height": ""
}
}
}
}
],
"can_cancel": true,
"show_weight": false,
"can_reorder": true,
"is_pending_payment": false,
"pending_payment_ends_at": 172796,
"checkout_url": "https://salla.sa/dev-nzzxsxjwinegxaa4/checkout/209nryYWDg2Xoqd1VOJaGLwKvrRY8l08vmA708NkE3zM6BlRe4bZxj5b",
"total_weight": "٠٫٢٥ كجم",
"shipment_branch": [],
"customer": {
"id": 225167971,
"first_name": "Mohammed",
"last_name": "Ali",
"mobile": 501806978,
"mobile_code": "+966",
"email": "usertest@gmail.com",
"urls": {
"customer": "https://salla.sa/dev-wofftr4xsra5xtlv/profile",
"admin": "https://s.salla.sa/customers/l7mYBdgXA9xJwWZRZK8WD42GNkZbjvRO",
"digital_content": "https://salla.sa/dev-k9dn7fok0vih4p70/orders/digital/lm6bowYMnmA9eyWdLkJza153vyZnMb85QO0GZ7NxDlVKXB4grqR82jEN"
},
"avatar": "https://cdn.salla.sa/customer_profiles/5i6SUhu9dlF1fvL3EcV98U644eOlG9jcEipz6dOo.jpg",
"gender": "female",
"birthday": {
"date": "1997-06-03 00:00:00.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"city": "جدة",
"country": "السعودية",
"country_code": "SA",
"currency": "SAR",
"location": "",
"updated_at": {
"date": "2022-06-22 10:20:14.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
}
},
"items": [
{
"id": 70815337,
"name": "بيتزا",
"sku": "54534534",
"quantity": 1,
"currency": "SAR",
"weight": 0.25,
"weight_label": "٠٫٢٥ كجم",
"amounts": {
"price_without_tax": {
"amount": 186,
"currency": "SAR"
},
"total_discount": {
"amount": 5,
"currency": "SAR"
},
"tax": {
"percent": "0.00",
"amount": {
"amount": 0,
"currency": "SAR"
}
},
"total": {
"amount": 186,
"currency": "SAR"
}
},
"notes": "",
"product": {
"id": 720881993,
"type": "food",
"promotion": {
"title": "اطلبها ساخنه",
"sub_title": "بيتزا خضار مشكل"
},
"status": "sale",
"is_available": true,
"sku": "54534534",
"name": "بيتزا",
"price": {
"amount": 66,
"currency": "SAR"
},
"sale_price": {
"amount": 45,
"currency": "SAR"
},
"currency": "SAR",
"url": "https://salla.sa/dev-wofftr4xsra5xtlv/بيتزا/p720881993",
"thumbnail": "https://cdn.salla.sa/bYQEn/buItWZf4OLbaTmL7vTMlDUWLOn20hfpq3QUbD2AB.jpg",
"has_special_price": false,
"regular_price": {
"amount": 66,
"currency": "SAR"
},
"calories": "600.00",
"mpn": null,
"gtin": null,
"favorite": null,
"starting_price": null
},
"options": [
{
"id": 1197801866,
"product_option_id": 60176141,
"name": "SIZE",
"type": "checkbox",
"value": [
{
"id": 408420634,
"name": "BIG",
"price": {
"amount": 120,
"currency": "SAR"
}
}
]
},
{
"id": 289546379,
"product_option_id": 1674915438,
"name": "الاضافات",
"type": "checkbox",
"value": [
{
"id": 152115913,
"name": "بصل",
"price": {
"amount": 0,
"currency": "SAR"
}
},
{
"id": 1526610378,
"name": "فلفل",
"price": {
"amount": 0,
"currency": "SAR"
}
}
]
}
],
"images": [],
"codes": [],
"files": []
}
],
"product_reservations": [
{
"id": 1289748598,
"from": "01:10",
"to": "01:40",
"date": "2023-04-18"
}
],
"bank": {
"id": 326553500,
"bank_name": "البنك الأهلي التجاري",
"bank_id": 1473353380,
"account_name": "Demo Account",
"account_number": "000000608010167519",
"iban_number": "SA2380000382608010130308",
"status": "active"
},
"tags": []
},
"pickup_branch": {
"id": 1345871747,
"name": "Branch",
"status": "active",
"location": {
"lat": "37.78044939",
"lng": "-97.8503951"
},
"contacts": {
"phone": "+201099999999",
"whatsapp": "+201099999999",
"telephone": "+201099999999"
},
"preparation_time": "ساعة 30 دقيقة",
"is_open": false,
"closest_time": {
"from": "08:00",
"to": "17:00"
},
"working_hours": [
{
"name": "الأحد",
"times": [
{
"from": "08:00",
"to": "17:00"
},
{
"from": "19:00",
"to": "23:30"
}
]
}
],
"is_cod_available": true,
"is_default": true,
"type": [],
"cod_cost": "15",
"country": {
"id": 1473353380,
"name": "السعودية",
"name_en": "Saudi Arabia",
"code": "SA",
"mobile_code": "+966"
},
"city": {
"id": 1,
"name": "الرياض",
"name_en": "Riyadh"
}
}
}Fields
Fields marked * are required in the official schema.
| Field | Type | Description |
|---|---|---|
event | string | Event Name One of: order.created, order.updated, order.refunded, order.deleted, order.products.updated, order.payment.updated, order.coupon.updated, order.total.price.updated, order.shipping.address.updated, order.cancelled, order.customer.updated. |
merchant | number | Merchant ID who installed the application on their store. Get details on the Merchant via the ID using the endpoint here |
created_at | string | Timestamp of webhook creation |
data | object |
data
| Field | Type | Description |
|---|---|---|
id * | number | A unique alphanumeric code or identifier assigned to a specific order. List of orders can be found here |
reference_id * | number | A specific alphanumeric identifier associated with an order. |
urls * | object (Urls) | |
date * | object (Date) | Date and Time of the order. |
source * | string | The source of the order. One of: store, landing, forgotten_basket, abandoned-cart, campaign, dashboard, buy_as_gift, mahly-app, buy_now, one-click, complete_order. |
source_device * | string | The machine or device used when the customer placed the order. |
source_details * | object | Order source details. |
status * | object (NewOrderStatus) | Order status. |
payment_method * | string | The specific payment option or financial mechanism chosen and used by a customer to pay for a product or service as part of an order, encompassing various methods. |
currency * | string | The currency in which order costs and prices are expressed and processed, based on the customer's preferences or the business's operational currency. |
amounts * | object | Order amounts. |
exchange_rate * | object | The order exchange rate. |
shipping * | object | Order Shipping details. |
shipments * | array of object (Shipment) | Order shipment details. |
can_cancel * | boolean | The option to enable order cancellation by the store customer.<br> True value should be set if the order status is in under review and in progress, as according to the store settings. |
show_weight * | boolean | Whether or not to show the weight value. |
can_reorder * | boolean | Whether or not to enable reorder . |
is_pending_payment * | boolean | The option of displaying order is pending payment to the customer when the order status is payment_pending. |
rating_link | string | The rating URL to review the order. 🛑 The variable is to be deprecated; use data.urls.rating variable instead. |
checkout_url | string | The checkout URL to settle payments related to the order 🛑 The variable is to be deprecated; use data.urls.checkout variable instead. |
pending_payment_ends_at * | integer | Last date allowed to customer to pay the order. |
total_weight * | string | Total weight value |
shipment_branch * | object (ShipmentBranch) | Order shipment branch details. |
customer * | object (Customer) | Customer details. |
items * | array of object | |
bank * | object | |
tags * | object (OrderTag) | Order Tag details. |
pickup_branch * | object (Branch) | Order pickup branch details. |
cart_reference_id * | number | A unique alphanumeric code or identifier assigned to a specific order cart. |
draft * | boolean | Whether or not the order 's status is set to draft |
receipt_image * | string | Order's image receipt |
read * | boolean | Whether or not the Merchant has read the order |
updated_at * | object (Date) | |
is_price_quote * | boolean | The option to quote order price. |
store * | object | Order store details. |
scope_exchange_rate * | string | The rate used to convert a transaction amount into the store's primary currency. |
type * | string | Order Type One of: gift, pre-order, normal. |
payment_methods * | array of object | List of payment methods associated with the order. |
Source
Generated from Salla's official documentation, fetched 2026-10-26. Found a difference from what Salla actually sends? Open an issue.