VI | EN
Message us on Messenger
Developer resources

Set SIP Overseas Discount for SIP affiliate region — Shopee API

v2.discount.set_sip_discount · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

v2.discount.set_sip_discount

POST/api/v2/discount/set_sip_discountVia 360: POST https://partner.quantri360.com/v1/shopee/api/v2/discount/set_sip_discount
Write endpoint — changes data on Shopee. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.
Description

CHỈ SHOP SIP: đặt tỷ lệ giảm giá cho mọi sản phẩm của shop liên kết theo thị trường, gọi bằng shop chính.

  • Gọi qua /v1/shopee/api/v2/discount/set_sip_discount với Authorization: Bearer <key>; dùng platform_shop_id khi có nhiều shop. 360 tự gắn partner_id, shop_id, sign và access_token.
  • API GHI: thay đổi dữ liệu thật trên Shopee; cần key có quyền ghi (can_write) và gói mở module Khuyến mãi. Thay đổi cấu hình ưu đãi hoặc giá khuyến mãi người mua thấy.
  • HTTP 200 vẫn có thể có lỗi nghiệp vụ; kiểm error trước khi dùng kết quả.
  • Áp dụng: gian hàng tham gia SIP. Gọi bằng shop chính; không áp dụng shop không tham gia SIP.
  • Không sửa trong vòng 15 phút sau lần cập nhật; tại VN không giảm quá 50%.

Request

Endpoint

POST https://partner.quantri360.com/v1/shopee/api/v2/discount/set_sip_discount

Authentication & shop

NameInTypeSampleDescription
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Request parameters

NameInTypeRequiredSampleDescription
regionbodystringYesTHThị trường của gian hàng SIP liên kết cần thay đổi giảm giá.
sip_discount_ratebodyint32Yes15Tỷ lệ giảm giá toàn thị trường, áp dụng cho mọi sản phẩm của shop SIP liên kết tại thị trường này.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/shopee/api/v2/discount/set_sip_discount" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"TH","sip_discount_rate":15}'
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/shopee/api/v2/discount/set_sip_discount",
    params={},
    json={
        "region": "TH",
        "sip_discount_rate": 15
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/shopee/api/v2/discount/set_sip_discount');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"region":"TH","sip_discount_rate":15}),
});
console.log(r.status, await r.json());
PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/shopee/api/v2/discount/set_sip_discount' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"region":"TH","sip_discount_rate":15}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by Shopee)

Phản hồi minh họa thành công; đọc error/message trước khi dùng kết quả.

NameTypeSampleDescription
request_idstringd52ca43b277a4f9292fb8be658bfd33dMã request của Shopee để tra lỗi.
errorstringMã lỗi Shopee; rỗng = thành công.
messagestringMô tả lỗi.
responseobjectKết quả xử lý.
regionstringTHThị trường của gian hàng SIP liên kết cần thay đổi giảm giá.
statusstringupcomingTrạng thái upcoming (sắp diễn ra) hoặc ongoing (đang diễn ra), không gồm khuyến mãi hết hạn.
sip_discount_rateint3215Tỷ lệ giảm giá toàn thị trường, áp dụng cho mọi sản phẩm của shop SIP liên kết tại thị trường này.
start_timetimestamp1794009600Thời điểm bắt đầu, Unix giây; 30 phút sau khi đặt sip_discount_rate.
end_timetimestamp1794182400Thời điểm kết thúc, Unix giây; 180 ngày sau bắt đầu.
create_timetimestamp1794007800Thời điểm tạo, Unix giây.
update_timetimestamp1794007800Thời điểm cập nhật gần nhất, Unix giây.

Response sample

{
  "request_id": "demo-request",
  "error": "",
  "message": "",
  "response": {
    "region": "TH",
    "status": "upcoming",
    "sip_discount_rate": 15,
    "start_time": 1794009600,
    "end_time": 1809561600,
    "create_time": 1794007800,
    "update_time": 1794007800
  }
}

Shopee error codes (14)

Show
CodeMeaning
error_dataDữ liệu không tồn tại hoặc không hợp lệ cho thao tác (vd mã không có, loại yêu cầu không cho phép).
error_paramTham số sai / thiếu / sai kiểu — xem `message` để biết tham số nào.
common.error_paramTham số không hợp lệ — xem `message`.
error_permissionGian hàng không có quyền xem dữ liệu này (vd yêu cầu trả / đơn không thuộc gian hàng).
error_serverLỗi hệ thống Shopee — thử lại sau ít phút.
error_shopGian hàng không hợp lệ — kiểm tra platform_shop_id.
SIP_DISCOUNT_ERROR_DISCOUNT_RATE_FOR_VNTại VN không được giảm quá 50%.
SIP_DISCOUNT_ERROR_INVALID_REGIONThị trường không hợp lệ hoặc chưa mở gian hàng.
SIP_DISCOUNT_ERROR_UPDATE_LOCKEDKhông sửa trong 15 phút sau lần cập nhật.
error_authỦy quyền gian hàng cho 360 đã hết hạn hoặc bị thu hồi (360 đã tự làm mới token một lần) — chủ gian hàng kết nối lại Shopee trong Partner.
error_limitChạm hạn mức gọi Shopee trong ngày của kết nối — 360 trả kèm thời điểm thử lại; giảm tần suất gọi.
error_rate_limitGọi quá nhanh — chờ vài giây rồi gọi lại (360 cũng giới hạn theo key: 429 + Retry-After).
shop_bannedGian hàng đang bị Shopee khóa — mọi API tạm ngưng tới khi gỡ khóa.
error_kyc_authGian hàng chưa hoàn tất đăng ký người bán trên Kênh Người Bán.

Get started

  1. Sign up for Partner
  2. Enable a data type of the Khuyến mãi (Marketing) group on the platform page
  3. Create an API key (tick the Shopee channel)
  4. Call it as in the examples above