Return Order Status Push

This is the cus payload format (HookCus.format_type = "cus", the default). A subscription created with a different format_type receives a different, much larger payload — ask Omisell before assuming this shape.
Delivery: POST with Content-Type: application/json and Authorization: <client secret> (the raw secret, no scheme prefix). request_id is generated per delivery attempt. Redirects are not followed — answer 2xx directly. Retries: up to 5, exponential backoff starting at 5 minutes.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200Your endpoint answers 2xx

application/json

Endpoint của bạn phải trả đúng 200. deliver_hook_cus coi mọi mã khác 200 — kể cả 201, 202, 204 — là THẤT BẠI và retry (5 lần: 5 / 10 / 20 / 40 / 80 phút). Lưu ý bộ giám sát sức khoẻ hook lại tính mọi 2xx là thành công, nên một endpoint trả 204 sẽ bị retry mà vẫn được coi là khoẻ. Không follow redirect — 3xx bị ghi nhận như một response, không đi theo.

Bodyapplication/json

curl --location 'https://api.omisell.com/webhook-url' \ --header 'Seller-ID;' \ --header 'Country;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "data": { "omisell_return_order_number": "RTNVN2606030D62FE4C", "return_order_number": "RTNVN2606030D62FE4C", "order_number": "EMP2_F230_SDALazada13", "shop_id": 11305, "status_id": 800, "status_name": "Returned", "created_time": 1780478979.0, "updated_time": 1780479063.0 }, "shop_id": 11305, "seller_id": 27001999, "platform": "retail", "event": "order_return.refund_paid", "timestamp": 1788315800, "request_id": "68b6f1c4a90c3e7f2d41b9e7" }'

Request

Responses