Order Refund Status Change Notification

Order Refund Status Change Notification
Webhook

Request

This webhook is designed to inform the developer's system whenever there is a change in the status of an order's refund application on the Keeta platform.

Event ID: 1005

Bodyapplication/jsonrequired

orderViewIdinteger, (int64)

Unique identifier for orders on Keeta platform

Example:756823555555859

shopIdinteger, (int64)

Unique identifier of the Keeta store

Example:466663

statusinteger

Refund status code

Example:2001

afterSaleOrderIdinteger, (int64)

Unique identifier for the after-sales application

Example:833443425408767

isAppealinteger

Indicates if this is an appealed refund request

Enum Value	Description
0	indicates a standard refund request
1	indicates a customer appeal case (requires platform intervention)

Example:0

picturesstring

The pictures field contains a JSON-formatted array string that stores URLs of images uploaded by customers as evidence for their refund requests. This field supports a maximum of 9 image URLs, with each URL separated by commas and properly escaped within the JSON array structure.

Example:"https://img-ap-hongkong.mykeeta.net/sailorproduct/9c760595674b395e330cf94b0e5068b0111111.jpg"

moneyinteger, (int64)

Refund amount

Example:2800

currencystring

Currency code for the refund amount

Example:"HKD"

applyOpTypeinteger

Code representing who initiated the refund request:

Enum Value	Description
0	System-automated refund
10	Customer-initiated refund
20	Merchant-initiated refund
30	Customer service-initiated refund

Example:10

applyReasonstring

Original reason for refund request

Example:"xxx"

handleOpTypeinteger

This field represents the code value corresponding to the type of personnel handling this after-sales application:

Enum Value	Description
0	indicates system-automated processing
10	indicates customer-initiated refund
20	indicates merchant-initiated refund
30	indicates Keeta customer service representative intervention

Example:20

handleReasonstring

This field indicates the reason why the after-sales application has been changed to its current status.

Example:"Merchant agree refund"

opTimeinteger, (int64)

Time when the event occurred, specified as milliseconds since Jan 1, 1970 (Unix epoch)

Example:1751448108144

Payload

{
  "orderViewId": 756823555555859,
  "shopId": 466663,
  "status": 2001,
  "afterSaleOrderId": 833443425408767,
  "isAppeal": 0,
  "pictures": "https://img-ap-hongkong.mykeeta.net/sailorproduct/9c760595674b395e330cf94b0e5068b0111111.jpg",
  "money": 2800,
  "currency": "HKD",
  "applyOpType": 10,
  "applyReason": "xxx",
  "handleOpType": 20,
  "handleReason": "Merchant agree refund",
  "opTime": 1751448108144
}

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