v2.discount.set_sip_discount
POST /api/v2/discount/set_sip_discount
Set SIP Overseas Discount for SIP affiliate region. Please use Primary shop's Shop ID to request, and provide the region and discount rate of the Affiliate shop to be set or update, the API will set or update the discount rate for that region's Affiliate shop.
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/discount/set_sip_discount
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Request Parameters
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| region | string | True | TH | The region of SIP affiliate shop that needs to set discount. |
| sip_discount_rate | int32 | True | 15 | The overall market discount rate that will apply to all items for SIP affiliate shop in current region. |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | Indicate error details if hit error. Empty if no error happened. | |
| message | string | Indicate error type if hit error. Empty if no error happened. | |
| request_id | string | The identifier for an API request for error tracking. | |
| response | object | ||
| region | string | TH | The region of SIP affiliate shop. |
| status | string | upcoming | The status of discount for SIP affiliate shop in current region, can be upcoming/ongoing, excluding expired discounts. |
| sip_discount_rate | int32 | 15 | The discount rate set for SIP affiliate shop in current region. |
| start_time | timestamp | 1741688426 | The start time of discount for SIP affiliate shop in current region, in UNIX seconds. Note: The start time is 30 minutes after the sellers set up the sip_discount_rate. |
| end_time | timestamp | 1757240426 | The end time of discount for SIP affiliate shop in current region, in UNIX seconds. Note: The end time is 180 days after the start time. |
| create_time | timestamp | 1741686627 | The create time of discount for SIP affiliate shop in current region, in UNIX seconds. |
| update_time | timestamp | 1741686627 | The latest update time of discount for SIP affiliate shop in current region, in UNIX seconds. |