MerchanSelfDelivery

'The endpoint below is restricted to merchant self-delivery orders and is only available for updates after the merchant accepts the order. Orders that are completed or cancelled cannot be updated.
Availability: This API is available starting August 16, 2025.'

Operations

Order Dispatched

Request

This endpoint allows merchants to notify the Keeta platform that a courier has picked up the order and the delivery is in progress for merchant self-delivery orders.

Notes:

This API is exclusively for merchant self-delivery orders where the merchant manages their own delivery service.
Calling this endpoint updates the order status to indicate that the courier has collected the order and delivery is underway.
The courier information provided helps customers track their delivery and contact the delivery person if needed.
This API can only be called after the order has been accepted by the merchant. It cannot be used to update orders that have been completed or cancelled.

Bodyapplication/jsonrequired

orderViewIdinteger, (int64)required

Unique identifier for orders on Keeta platform

Example:123456789

shopIdinteger, (int64)required

Unique identifier of the Keeta store

Example:987654321

courierInfoobject(CourierInfo)

Comprehensive courier information for self-delivery orders, including personal details, contact information, and vehicle specifications.

curl -i -X POST \
  https://open.mykeeta.com/api/open/order/dispatched \
  -H 'Content-Type: application/json' \
  -d '{
    "orderViewId": 123456789,
    "shopId": 987654321,
    "courierInfo": {
      "courierId": 123456,
      "courierName": "أحمد محمد",
      "courierPhone": "501234567",
      "courierVehicle": 3,
      "courierPhoneInterCode": "966",
      "vehiclePlateNumber": "DXB-A-12345",
      "courierLastName": "محمد",
      "courierFirstName": "أحمد"
    }
  }'

Responses

Courier pickup notification successful

Bodyapplication/json

codeintegerrequired

A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

Enum Value	Description
0	The request was executed successfully.
Non-zero value	The request execution failed. Specific error details can be viewed in the message field.

Example:0

messagestringrequired

Text description corresponding to the status code, explaining the operation result or error cause to users.

Example:"Success"

Response

{
  "code": 0,
  "message": "Success"
}