Order Status Changed

Webhook

POST

order.status.changed

Triggered when an order item's status changes. Fetch the latest order state from the Get Order API for business logic.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "eventId": "01K0AZRPB4N36H9NMDJRMYXM7A",
    "eventType": "order.status.changed",
    "payloadVersion": "v1",
    "data": {
        "orderId": 100,
        "orderItems": [
            {
                "orderItemId": 1001,
                "pid": 503344,
                "orderStatus": "PAYMENT_RECEIVED"
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Bun-Webhook-Signature: t=1735648123,v0=249e47edc1980531306517e4435b54ef1ff224020029284bdf19c8eda99aa325' \
--header 'Content-Type: application/json' \
--data '{
    "eventId": "01K0AZRPB4N36H9NMDJRMYXM7A",
    "eventType": "order.status.changed",
    "payloadVersion": "v1",
    "data": {
        "orderId": 100,
        "orderItems": [
            {
                "orderItemId": 1001,
                "pid": 503344,
                "orderStatus": "PAYMENT_RECEIVED"
            }
        ]
    }
}'

Responses

🟢204Success

Webhook successfully received. Any 2xx status code is treated as success; the response body is ignored.

This response does not have a body.

Modified at 2026-05-14 06:57:17

Events

WebhookEnvelope