# Order Cancellation

This endpoint allows merchants to request order cancellation through the Keeta platform when they are unable to fulfill a customer's order.


1. The developers should only invoke this API when the merchant is 
2. Upon successful cancellation, the order status will be updated to  in Keeta's system and Keeta will  to the customer.
3. This API . If the order is already in a  state, the system will return an error response.
4. Merchants should  before proceeding to avoid unnecessary losses.


Endpoint: POST /order/cancel
Version: v.1.0.0

## Request fields (application/json):

  - `orderViewId` (integer, required)
    Unique identifier for orders on Keeta platform
    Example: 756823555555859

  - `shopId` (integer, required)
    Unique identifier of the Keeta store
    Example: 466663

  - `cancelCode` (integer, required)
    This field represents the code value for the reason an order was canceled. Please send the corresponding cancellation reason code for the merchant's order cancellation in this field.
    Enum: 500000, 500001, 500002, 500003

  - `cancelReason` (string)
    This text field provides a detailed explanation for the cancellation when using the generic reason code (500000).
    Example: "too expensive"

## Response 200 fields (application/json):

  - `code` (integer, required)
    A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

  - `message` (string, required)
    Text description corresponding to the status code, explaining the operation result or error cause to users.
    Example: "Success"