UpdateSKU

Updates one or more fields of an existing SKU. Fields that require audit approval (e.g. names, category, path) will trigger a review before taking effect; price fields (sellingPrice, originalPrice, discountPercentage) take effect immediately without audit.

Host: dip-cb.binanceapi.com

PATCH /mp-api/v1/apps/{appId}/skus/{skuId}

Header

Parameter	Required	Description
X-Mp-Open-Api-Token	Yes	JWT token. Please refer to Description of External Interface Signature Authentication Algorithm

Path Parameters

Parameter	Description
appId	The AppId of the mini program
skuId	The skuId of the SKU

Body Parameters

Parameter	Type	Required	Description	Example
category	string	No	Category of this SKU. See Valid Categories below.	"Games"
coverImageFileId	string	No	FileId for SKU cover image obtained via UploadFile	f7574adb-0ccb-4281-9ed6-943f11a1e85a
names	{[key:string]: string}	No	Name map for this SKU. `en` is required. Maximum length per name is 128 characters.	{"en": "pubg 100 point"}
originalPrice	number	No	Price in USD. Must be a positive number. Sub-cent amounts are truncated (e.g., 9.9999 → 9.99).	9.99
sellingPrice	number	No	Selling price in USD. Must be a positive number. Sub-cent amounts are truncated (e.g., 9.9999 → 9.99).	6
discountPercentage	int	No	Discount percentage for display only. Valid range: 0–99.	32
countryWhitelist	Array<String>	No	Countries eligible to display this SKU. Use ISO 3166-1 alpha-2 codes. If empty, SKU can be displayed in all countries.	["JP"]
countryBlacklist	Array<String>	No	Countries restricted from displaying this SKU. Use ISO 3166-1 alpha-2 codes.	["CN", "GB"]
path	string	No	Path to the SKU page. Maximum length is 1024 characters. Query string parameters (after `?`) are parsed and stored separately.	/hello/world?foo=bar
description	string	No	Optional description for this SKU.	A virtual top-up item

Note:

All updates, except for sellingPrice, originalPrice, and discountPercentage, need audit approval.
Updating each field will overwrite its entire original value.

Request Body

​{
  "names": {
       "en": "PUBG 100 points",
       "zh-TW": "PUBG 100 點",
  },
  "countryWhitelist": ["JP"],
  "countryBlacklist": ["CN", "TW"]
}

Response

HTTP 200 in JSON

{
  "code": "000000",
  "message": null,
  "data": {},
  "success": true
}

ErrorCode	Remark
000000	Success
900001	Invalid Parameter
900002	JWT Authentication Failed
900003	Unexpected Error
900004	Invalid FileId
900260	Invalid SkuId

Valid Categories

Category
AI Tools
eSIM
Fashion & Beauty
Food & Grocery
Entertainment
Games
Payments
Shopping
Telecom & Utilities
Travel

UpdateSKU

Valid Categories​

Valid Categories