Order Status Change Callback

Platform notification to channel partner when order status changes. The platform sends a POST request to the channel partner's configured NOTIFY_URL.

Signature Verification

The signature is generated using HMAC-SHA1:

Sort the data object keys alphabetically

Concatenate key=value pairs with & (JSON-encode array values)

Append &timestamp={time}&nonce_str={nonce_str}

Sign with HMAC-SHA1 using APP_SECRET as the key

Order Status Table:

Status	Description
WAIT_MERCHANT_CONFIRM	Pending merchant acceptance
WAIT_DRIVER_CONFIRM	Waiting for rider acceptance
MERCHANT_CONFIRMED	Merchant accepted
DRIVER_CONFIRMED	Rider accepted
DRIVER_ARRIVED	Rider arrived at store
DRIVER_DELIVERING	Rider delivering
DRIVER_DELIVERED	Rider delivery completed
WAIT_COMMENT	Pending review
MERCHANT_DELIVERING	Merchant started delivery
MERCHANT_DELIVERED	Merchant delivered
ORDER_DONE	Completed
ORDER_REFUNDED	Refunded
ORDER_CANCEL	Cancelled

Parameter Encryption Method:

Signature generation rules:
$data_str = Sort the data array by key in ascending order and concatenate with &. If the value is an array, perform json_encode first;

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "time": 1760143449,
    "nonce_str": "abc123random",
    "sign": "a1b2c3d4e5f6...",
    "data": {
        "openid": "merchant_openid_xxx",
        "type": "ORDER_STATUS_CHANGE",
        "data": {
            "order_id": "5208510",
            "status": "MERCHANT_CONFIRMED"
        },
        "label": "Merchant Confirmed"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Signature Verification#

Request

Request Code Samples

Responses

Signature Verification