快工助手跨境电商知识与商机助手

Create your App

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 Create your app in Partner Center

Creating an app in Partner Center establishes the workspace and credentials you need to integrate with TikTok Shop services. In this workspace, you choose the app type, service category, market, seller type, API scopes, redirect URL, webhook settings, and app credentials. This guide covers the full app creation flow and the decision between Public app and Custom app. For the OAuth-only setup flow, use Create a TikTok Shop app OAuth client. That page should focus on the OAuth client configuration: redirect URL, authorization link, authorization code, token exchange, and refresh-token handling.

#

§2 Before you create an app

Complete this checklist before clicking Create app & service:

CheckWhy it matters
Developer account and onboarding are complete or in progressPartner Center app creation depends on your developer account status and developer type. See Developer onboarding.
Developer type is clearISVs, seller developers, system integrators, and partners can follow different review and launch paths.
App type is clearChoose Public app if sellers should discover the app in the App and Service Store. Choose Custom app if the app is distributed privately by authorization link.
Service category is clearCategory affects available scopes, review expectations, and app positioning. Connector apps may have additional review requirements.
Target market and seller type are confirmedTreat Market and Seller type as creation-time choices. They may not be editable after app creation, so confirm them before creating the app.
Redirect URL is readyNeeded to receive the authorization code after a seller or partner authorizes your app. Use a secure backend-controlled endpoint.
Webhook URL is ready, if neededNeeded to receive push notifications for order, product, fulfillment, authorization, and other events.
Compliance and legal review path is understoodReview requirements vary by app type, category, market, and data access. US and UK partners should start compliance/legal review early because it can take three or more weeks.
#

§3 App type decision

There are two main app types: public and custom.

ItemPublic appCustom app
VisibilityListed in the TikTok Shop App and Service Store after approval. Sellers can discover, install, and authorize it.Not listed publicly. Developers share a private authorization link with selected sellers.
Typical use caseSaaS or integration app intended for many sellers.Seller-specific or partner-managed solution, often built for one seller or a limited seller group.
App listing detailsRequired for store listing.Usually not required unless Partner Center requests them.
DistributionApp and Service Store listing.Private authorization link.
Review standardPublic apps require app review before listing.Custom apps usually launch privately without public-app listing review, but app review is required if the app is a Connector app, reaches 25 or more seller authorizations, or Partner Center / your partner manager indicates review is required for the selected category or market.

Standard wording to reuse across related docs:

Custom apps usually launch privately by authorization link. App review is required only for applicable custom apps, such as Connector apps, custom apps with 25 or more seller authorizations, or apps in a category or market where Partner Center requests review.
#

§4 Connector and 25-seller review rule

A Connector app is an app category for integrations that connect TikTok Shop with an external system, such as an ecommerce platform, ERP, OMS, WMS, 3PL, feed tool, or other seller operation system. Connector apps typically sync product, order, inventory, fulfillment, or other seller data across systems, so TikTok Shop may require review even if the app is distributed privately. For custom apps:

  • If the app category is Connector, prepare for app review.
  • If the app reaches 25 or more seller authorizations, prepare for app review before broader use.
  • If Partner Center shows a review-required status, review banner, publish restriction, or Submission materials for review entry, follow that flow before expanding distribution.
  • If you believe the app is below the threshold but still sees a review requirement, contact your partner manager or submit a Partner Center support ticket with the app key, service ID, app category, market, seller type, and screenshots.
#

§5 Create the app

To create your app:

  1. Sign in to the correct Partner Center for the target market.
  2. Open App & Service from the navigation panel.
  3. Click Create app & service.
  4. Select Public or Custom.
  5. Select the Service category and set the default name.
  6. Optionally upload a logo.
  7. Select Market and Seller type.
  8. Turn on Enable API if the app will call TikTok Shop APIs.
  9. Configure the redirect URL and webhook URL.
  10. Click Create.

Field reference:

FieldMeaningNotes
App typePublic or Custom.Choose based on how sellers will discover and authorize the app.
Service categoryThe business category of the app, such as Connector or another category shown in Partner Center.Category can affect available scopes, review requirements, and launch flow.
Default nameThe default app/service name shown in Partner Center and used as fallback display text.Public apps may need localized listing content later.
LogoApp icon or logo.Optional during initial creation, but public listings usually require polished brand assets.
MarketThe market where the app will operate or be listed.Confirm before creation. If the market is wrong and Partner Center does not allow editing, create a new app or contact support.
Seller typeSeller model supported by the app.Local usually means local-to-local seller/shop scenarios. Cross-border means cross-border seller scenarios and may require additional identifiers such as shop_cipher or global product flows.
Enable APITurns on API integration setup for the app.Enable this if the app needs OpenAPI scopes, seller authorization, token exchange, or webhooks.
Redirect URLCallback endpoint that receives the authorization code.The token API uses the returned code value as the auth_code parameter.
Webhook URLCallback endpoint that receives event notifications.You can also manage shop webhooks later through Events API and Partner Center webhook settings.
#

§6 Authorization domains and token exchange

Do not mix authorization entry domains, token domains, and OpenAPI resource domains. They serve different purposes.

PurposeUS domain / endpointROW domain / endpointUse when
Partner Center account, app creation, and documentationhttps://partner.us.tiktokshop.comhttps://partner.tiktokshop.comCreate or manage developer account, apps, services, reviews, and support tickets.
Seller authorization entryhttps://services.us.tiktokshop.com/open/authorizehttps://services.tiktokshop.com/open/authorizeA seller authorizes your app to access seller-owned shop data.
Partner authorization entryhttps://partner.us.tiktokshop.com/open/authorizehttps://partner.tiktokshop.com/open/authorizeA partner authorizes access to partner-owned business category data, such as approved Affiliate Partner APIs.
Token exchangehttps://auth.tiktok-shops.com/api/v2/token/getSameExchange an authorization code for access_token and refresh_token.
Token refreshhttps://auth.tiktok-shops.com/api/v2/token/refreshSameRefresh an expired access token.
OpenAPI resource callshttps://open-api.tiktokglobalshop.comSameCall business APIs after you have a valid token and signature.

Use the authorization guide that matches the data owner:

After authorization, TikTok Shop redirects to your configured Redirect URL with a one-time authorization code. The redirect parameter is commonly shown as code; pass that value to the token API as auth_code. Token exchange example:

GET https://auth.tiktok-shops.com/api/v2/token/get?app_key={app_key}&app_secret={app_secret}&auth_code={code_from_redirect}&grant_type=authorized_code

Required token parameters:

ParameterRequiredDescription
app_keyYesThe App Key generated for your app in Partner Center.
app_secretYesThe App Secret generated for your app. Keep it server-side and never expose it in frontend code, logs, screenshots, or tickets.
auth_codeYesThe authorization code returned to your Redirect URL. The code is short-lived and one-time use.
grant_typeYesMust be exactly authorized_code. Do not use the standard OAuth spelling authorization_code.
#

§7 App credentials

After creation, Partner Center displays the app or service detail page. You can find the app credentials later from:

Partner Center
  -> App & Service
  -> Select your app or service
  -> App credentials / Basic information
CredentialMeaningHandling requirement
App KeyPublic identifier of the app/service.Used in token requests and signed OpenAPI requests.
App SecretSecret key generated for the app/service.Store only on the server side. Use it for token exchange and request signing. Do not expose it to browsers, mobile apps, client-side scripts, screenshots, or logs.
Service IDIdentifier used by some authorization-link flows.Use it when building authorization links manually or when Partner Center asks for service-level identification.
#

§8 Scope and authorization checks

Creating the app is not enough to call APIs. Before asking sellers to authorize:

  1. Enable only the API scopes your app needs.
  2. Confirm the endpoint's required scope in the API reference.
  3. Complete seller authorization after the required scopes are enabled.
  4. Check the granted_scopes field in the token response to confirm the seller granted the expected scopes.
  5. If you add scopes later, ask the seller to reauthorize so the new token includes the new scopes.
#

§9 Document boundaries

Use these pages together, but keep their responsibilities separate:

PageOwnsDoes not own
Create your AppApp type selection, app creation fields, market/seller type choice, credentials, and high-level review rules.Detailed OAuth callback implementation or token refresh logic.
Create a TikTok Shop app OAuth clientOAuth client setup, redirect URL behavior, authorization code handling, token exchange, and refresh-token flow.Public vs custom app strategy or app launch review path.
App development overviewEnd-to-end development lifecycle: design, create, test, review, launch.Field-by-field app creation instructions.
App launch overviewPublish and launch path for public and custom apps.Initial app creation details.
App review processReview materials, review workflow, and review status.OAuth token exchange or API signing.
#

§10 Next steps

After creating the app:

  1. Configure required API scopes in Partner Center.
  2. Configure and test the Redirect URL.
  3. Configure webhook topics if the app relies on event notifications.
  4. Generate a test authorization code and exchange it for tokens.
  5. Call Get Authorized Shops to confirm the token and shop mapping.
  6. Test with Development Shop and API Testing Tool.
  7. Follow the applicable launch or review path for the app type, category, market, and seller authorization scale.
#