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

Your endpoint must return exactly 200. deliver_hook_cus treats every other code — including 201, 202 and 204 — as a FAILURE and retries it (5 attempts: 5 / 10 / 20 / 40 / 80 minutes). Note that the hook health monitor counts any 2xx as a success, so an endpoint returning 204 is retried and still reported as healthy. Redirects are not followed — a 3xx is recorded as a response, not followed.

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