Order Placed Notification

Order Placed Notification
Webhook

Request

This webhook is sent by Keeta to notify the developer's system that a new order has been placed.

Event ID: 1001

Notes: In the event that Keeta's platform sends a new order notification but does not receive an acknowledgment from the developer's system, Keeta will attempt to resend the notification up to a maximum of three additional times.

⚠️ IMPORTANT: Certain merchant settlement amount fields within the order detail query API and order push notifications may be subject to calculation delays. All fields under feeDtl.merchantFee, which represent various components of the merchant settlement breakdown, may not be fully computed at the time the order detail is first returned or the order push notification is received. In such cases, the affected fields may be absent, null, or contain incomplete values. Service providers must not treat feeDtl.merchantFee fields as hard dependencies in their integration logic. If missing or incomplete settlement data is encountered, it is recommended to re-query the Order Detail API after a short delay to retrieve the updated settlement information. Downstream business logic such as reconciliation and invoicing should be designed to handle the temporary unavailability of these fields gracefully, without blocking or failing the overall order processing flow.

Bodyapplication/jsonrequired

orderInfoobject(OrderInfoDTO)required

This structure contains all the detailed information about the order (such as order delivery information, recipient information, cost information, etc.)

Payload

{
  "orderInfo": {
    "baseOrder": { … },
    "merchantOrder": { … },
    "merchantOrderDeliveries": [ … ],
    "deliveryInfos": [ … ],
    "orderPromotionDtlList": [ … ],
    "refundInfos": [ … ],
    "recipientInfo": { … },
    "feeDtl": { … },
    "rebates": { … },
    "rebatesTag": true,
    "products": [ … ],
    "bigOrderTag": true,
    "subOrderInfoList": [ … ]
  }
}

Responses

Request executed successfully

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"
}