Tài liệu một trang hướng dẫn onboarding cho Seller Developer

Phần 1: Tổng quan về onboarding

1. Danh sách API.
2. Hướng dẫn phát triển app.

Hướng dẫn onboarding cho seller developer

Luồng kinh doanh của TikTok Shop

Tìm hiểu về những gì TikTok Shop API có thể làm - hành trình người dùng

Quy trình onboarding

Định nghĩa và giới thiệu cơ bản về nghiệp vụ

• TikTok Shop: TikTok Shop là một tính năng mua sắm mới mang tính đột phá, cho phép người bán, thương hiệu và nhà sáng tạo trưng bày và bán sản phẩm trực tiếp trên TikTok thông qua video trong nguồn cấp, LIVE, tab trưng bày sản phẩm và Shop Tab (tab thứ 2 của ứng dụng TikTok) tại một số thị trường.
• TikTok Shop Partner Center (TTSPC): Xây dựng các tích hợp phần mềm và ứng dụng sử dụng TikTok Shop API để giúp bạn quản lý, tự động hóa và phát triển hoạt động kinh doanh trên TikTok Shop. Là người bán, bạn cũng có thể tích hợp trực tiếp TikTok Shop của mình với app để quản lý công việc kinh doanh.
• TikTok Shop seller developers: Chọn loại này nếu bạn là một người bán trên TikTok Shop chỉ có ý định phát triển các app và dịch vụ tùy chỉnh tích hợp trực tiếp với TikTok Shop để hỗ trợ cho hoạt động vận hành của riêng mình.

Luồng kinh doanh của TikTok Shop

Chỉ tạo một App riêng tư (private App) nếu bạn có tài khoản người bán TikTok Shop.

Trước tiên bạn cần có một tài khoản người bán TikTok Shop.

Bước 1: Tạo tài khoản trên TikTok Shop Partner Center

Truy cập TTSPC: https://partner.tiktokshop.com/

• Nếu bạn có giấy phép kinh doanh tại Mỹ và loại người bán mục tiêu là local tại Mỹ, vui lòng truy cập US TikTok Shop Partner Center (TTSPC) https://partner.us.tiktokshop.com/
• Đối với các trường hợp khác, vui lòng tham khảo https://partner.tiktokshop.com/
• Thiết lập tài khoản trên Partner Center. Cung cấp địa chỉ email và, không bắt buộc, số điện thoại của bạn. Hãy đảm bảo địa chỉ email của bạn trên Partner Center luôn được cập nhật, vì đây là yếu tố thiết yếu để nhận các cập nhật quan trọng từ nền tảng Partner Center.
• ⚠️ Lưu ý rằng địa chỉ email của seller center và TTSPC là giống nhau.

Bước 2: Đăng ký làm TikTok Shop seller developer

	Mô tả	Ảnh chụp màn hình
1	Sau khi tạo tài khoản, bạn sẽ thấy một hướng dẫn kinh doanh được điều chỉnh phù hợp với từng loại đối tác khác nhau. Chọn "For TikTok Shop Seller" làm loại đối tác của bạn từ hướng dẫn này, nhấp vào 'Start Business', và nó sẽ dẫn bạn đến trang 'Get Started' để bắt đầu đơn đăng ký cho danh mục bạn đã chọn.
2	Nhấp vào "Start Business" để bắt đầu đơn đăng ký đối tác của bạn.
3	Bước đầu tiên, TikTok Shop cần biết loại App nào bạn dự định xây dựng cho người bán. Vui lòng chọn thị trường người bán mục tiêu và danh mục. Vui lòng chọn 「TikTok Shop Seller」làm danh mục kinh doanh.
4	Vui lòng xác minh tài khoản người bán của bạn bằng thông tin đăng nhập và mật khẩu (email hoặc số điện thoại). TikTok Shop Partner Center sẽ tự động xác minh tài khoản.
5	Khi đã được xác minh, bạn sẽ thấy thẻ "TikTok Shop seller" dưới trang My Account. Trước tiên bạn cần có một tài khoản người bán TikTok Shop

Bước 3: Xác minh tài khoản người bán

1. Điền thông tin cơ bản và xác minh tài khoản người bán

• ⚠️ Bạn chỉ có thể xác minh tài khoản người bán TikTok Shop đã vượt qua quá trình xét duyệt KYB/KYC
• 1 tài khoản người bán chỉ có thể được liên kết với 1 tài khoản TTSPC.

1. Điều quan trọng đối với chúng tôi là hiểu về hoạt động kinh doanh của bạn. Hãy điền thông tin đối tác

Thông tin kinh doanh		Ảnh chụp màn hình
Giới thiệu công ty	Partner logo
Business Description: Khuyến nghị nêu rõ năng lực cốt lõi, kinh nghiệm kinh doanh, các trường hợp vận hành, v.v. của công ty bạn.
Website
Thông tin liên hệ	Contact email
Contact phone number
Thông tin thêm về bạn	Có bao nhiêu khách hàng/ nhà bán hàng sử dụng app/ nền tảng/ dịch vụ của bạn?
Bạn có cơ hội bán hàng tức thời nào mà chúng tôi có thể hỗ trợ hoặc danh sách khách hàng chính không?
Bạn đã từng làm việc với những nền tảng thương mại điện tử nào?

1. Điền vào biểu mẫu xét duyệt onboarding, bao gồm giấy phép kinh doanh và các chứng nhận khác trước khi xuất bản App.

Bước 4: Điền biểu mẫu liên quan đến chứng nhận

• Seller Developer cần hoàn tất việc lựa chọn danh mục mới và nộp các tài liệu bắt buộc cho vai trò mới.
• Thông tin liên quan đến chứng nhận sẽ không thể chỉnh sửa về sau. Seller Developer nên điền thật cẩn thận
• Lưu ý: Các điều kiện bắt buộc khác nhau tùy theo từng quốc gia, và sẽ tuân theo quy trình xét duyệt onboarding trên trang "my account".

	Trường thông tin	Có phải trường bắt buộc không	Quy tắc
Business Information	Certificate of Incorporation copy	Required	1. 1. Giấy phép kinh doanh hợp lệ và xác thực

2. 2. Giấy phép kinh doanh yêu cầu bản scan màu với hình ảnh rõ nét và đầy đủ đường viền, và phải được đóng dấu chính thức
3. 3. Người nộp đơn phải thuộc loại hình doanh nghiệp
4. 4. Giấy phép kinh doanh CN Mainland phải bao gồm "technical services" hoặc "technical development" hoặc "software development" | | company legal name | Required | Cần phải nhất quán với thông tin trên giấy phép kinh doanh. | | Certificate of Incorporation No. | Required | | Certificate effective period | Required | | company register date | Required | | company termination date | Certificate effective period = Appointed period, bắt buộc Certificate effective period = Permanent, N/A | | Identity Documents | Identity card copy | Required (Chọn bất kỳ một trong ba) | 1. Tài liệu nhận dạng cá nhân hợp lệ và xác thực
5. Yêu cầu bản scan màu | | Identity card copy | | Passport copy | | Name and Logo | partner name | Required | 1. Không cho phép các tên liên quan đến TikTok/TikTok Shop như TT/TK/TikTok/TikTik/TokTok/TikTok Shop/TTS/TKS, v.v.
6. Không được là một chuỗi dài các số/ký tự, hoặc các số/ký tự ngẫu nhiên mà người bình thường không thể hiểu được.
7. Không được liên quan đến các từ về khiêu dâm, cờ bạc, ma túy, bạo lực hoặc các hoạt động bất hợp pháp. | | Work Environment | work environment nonstandard | Required | 1. Môi trường văn phòng thật: Bức ảnh không được trông giả tạo rõ ràng hoặc có dấu vết chỉnh sửa ảnh.
8. Các bức ảnh phải bao gồm tối thiểu lối vào chính của công ty (khu vực lễ tân) và các khu vực chức năng quan trọng.
9. Tên công ty hiển thị ở lối vào chính hoặc các khu vực quan trọng phải khớp với tên pháp nhân. |

Bước 5: Tạo App

	Mô tả	Ảnh chụp màn hình
1	Chọn App & Service từ bảng điều hướng. Partner Center hiển thị trang 「App & service」.
2	Nhấp vào nút「**Create app & service」**ở góc trên bên phải trang. Partner Center hiển thị trang「Create app & service」.
3	Xây dựng một Custom App: Custom App Loại App này thường được phát triển cho một người bán cụ thể. Nó được tùy chỉnh để đáp ứng các nhu cầu, yêu cầu hoặc sở thích kinh doanh cụ thể của một người bán. App này không được liệt kê trên TikTok Shop App Store. Bạn có thể phân phối App này cho từng người bán bằng cách chia sẻ liên kết ủy quyền của App.
4	Chọn Service category và đặt default name cho App của bạn. Tùy chọn, tải lên một logo cho App. Vui lòng chọn 「TikTok Shop Seller」làm danh mục kinh doanh.
5	Chọn Market và đặt seller type cho App của bạn.
6	Bật công tắc Enable API và hoàn thành các trường sau. Nếu không, bỏ qua sang bước tiếp theo.
Redirect URL Nhập URL để nhận authorization code của bạn. Sau khi người bán ủy quyền cho App, nó sẽ chuyển hướng đến URL này (có thể là URL của trang web trong hệ thống của bạn) và truyền auth_code, mà bạn có thể dùng để lấy access_token.
Webhook URL Tùy chọn, nhập URL để nhận push notifications (có thể là URL của hệ thống của bạn).
7	Nhấp Create để hoàn tất quy trình. Sau khi bạn tạo App, Partner Center hiển thị trang chi tiết App and service. Tại đây bạn có thể truy cập App key và secret duy nhất của App, cho phép bạn hoàn tất ủy quyền người bán và gọi API.
App Key - Mã định danh duy nhất của dịch vụ.

• App Secret - Khóa ứng dụng do nền tảng tạo ra khi bạn tạo một App. Bạn có thể dùng secret này để lấy API access token. |

Bước 6: Kiểm thử App của bạn

Trước khi có thể ra mắt App, bạn phải kiểm thử kỹ lưỡng với chức năng Seller Center của TikTok Shop. Chúng tôi cung cấp các công cụ dành cho nhà phát triển sau đây mà bạn có thể dùng để kiểm thử chức năng App của mình với Seller Center.

• Development Shop (trước đây gọi là Sandbox)
• API Testing Tool

Công cụ Development Shop (trước đây gọi là Sandbox) trong Partner Center cho phép bạn xây dựng và kiểm thử app bằng cách mô phỏng nhiều luồng công việc của người bán mà không ảnh hưởng đến dữ liệu cửa hàng thật, trong khi API Testing Tool cho phép bạn truy cập các tham số của request và response API.

Thiết lập Development Shop

Cấu hình trên trình duyệt web hoặc tệp host của hệ thống sau đây sẽ cho phép bạn kết nối với môi trường kiểm thử của TikTok Shop, để bạn có thể tạo cửa hàng kiểm thử, kiểm thử các tích hợp API trước khi phát hành chính thức.

Custom App

Với Development Shop, các nhà phát triển có thể truy cập tất cả tính năng của môi trường production, bao gồm trả hàng, hoàn tiền, khuyến mãi và chức năng hỗ trợ khách hàng.

Tìm hiểu thêm: [Seller Center development shops](https://partner.tiktokshop.com/docv2/page/seller-center-development-shops#Back To Top)

Cách kiểm thử API Việc kiểm thử tích hợp app của bạn với TikTok Shop bao gồm việc gọi đúng các API của chúng tôi. Chúng tôi khuyến nghị tham khảo các hướng dẫn chi tiết để tìm hiểu cách bạn có thể gọi và kiểm thử API: - API Testing Tool - Hướng dẫn này cung cấp thông tin về cách sử dụng API Testing Tool của chúng tôi để truy cập hiệu quả các tham số request và response chính xác ngay trên Partner Center. - How to call TikTok Shop Open API - Hướng dẫn này bao gồm các endpoint URI và tham số, v.v. để gọi các API của chúng tôi. - How to call APIs using Postman - Sử dụng Postman để đơn giản hóa việc kiểm thử API. Hướng dẫn này cho thấy cách thiết lập script, environment và request trong Postman để kiểm thử TikTok Shop API.

Cách nhận trợ giúp khi kiểm thử app của bạn Nếu bạn có thắc mắc về việc kiểm thử app, bạn có thể kết nối với đội ngũ Partner Center Support theo các cách sau: - Liên hệ với chúng tôi qua email - Gửi ticket qua Partner Console (yêu cầu đăng nhập)

Bước 7: Xuất bản App

Sau khi hoàn tất đăng ký và tích hợp, bạn đã hoàn thành tất cả các bước cần thiết để xuất bản custom app của mình. Vui lòng nhấp 「Publish」và sau đó App sẽ được xuất bản tự động.

Bước 8: Ủy quyền

Ngoài ra, bạn có thể mở liên kết ủy quyền trực tiếp và ủy quyền cho cửa hàng của bạn. Liên kết này đóng vai trò là phương tiện để người bán ủy quyền cho ứng dụng của bạn theo cách cá nhân hóa và nhắm mục tiêu hơn.

Không có thông tin

Phần 2: Câu hỏi thường gặp

1. Nếu tôi có câu hỏi về API, tôi có thể liên hệ TikTok Shop ở đâu?

1. Câu hỏi về cửa hàng nội địa Mỹ hoặc xuyên biên giới: https://partner.us.tiktokshop.com/ticket/center
2. Câu hỏi về cửa hàng ngoài Mỹ: https://partner.tiktokshop.com/ticket/center

2. Tôi có thể đăng ký làm ISV không?

1. Ngoại trừ seller inhouse developer - TikTok shop seller, tất cả các danh mục khác đều thuộc về các danh mục ISV.
2. Chỉ khi bạn có dịch vụ cho tất cả người bán trong thị trường của mình, bạn mới có thể đăng ký làm ISV.
3. ISV cần vượt qua quá trình xét duyệt bảo mật tuân thủ phức tạp, nhưng seller developer thì không.

3. Tôi có cần thực hiện xét duyệt tuân thủ / chức năng App không?

1. Đối với ISV: Xét duyệt bảo mật được miễn nếu đăng ký phù hợp với quy định của địa phương.
2. Đối với seller: Xét duyệt bảo mật là bắt buộc. Vì bạn đang đăng ký để trở thành ISV, bạn phải thực hiện xét duyệt bảo mật tuân thủ và xét duyệt chức năng app. Lưu ý: Biểu mẫu bảo mật phải được hoàn thành bằng tiếng Anh với thông tin trung thực. Ba lần bị từ chối liên tiếp sẽ dẫn đến việc tự động đưa tài khoản vào danh sách đen.

4. Tôi có thể vô hiệu hóa một App không?

Không. Sau khi App được tạo, nhà phát triển không thể xóa App. Nhưng nhà phát triển có thể vô hiệu hóa một App. Sau khi App bị vô hiệu hóa, App không thể được đưa lên trực tuyến trở lại.

5. Tôi không thể liên kết tài khoản người bán TikTok Shop của mình. Lỗi này có nghĩa là gì?

1 tài khoản người bán chỉ có thể được liên kết với 1 tài khoản TTSPC. Vui lòng sử dụng một tài khoản người bán khác để liên kết/xác minh

6. Tôi không thể xác minh tài khoản seller center. Lỗi này có nghĩa là gì?

1. Lỗi: "Please use the same email/phone number for verification as for login"
2. Vui lòng xác minh tài khoản TikTok Shop của bạn để được chứng nhận là TikTok Shop Seller.
3. TTSPC login email = Seller Center login email = verification email

7. Lỗi này có nghĩa là gì: email/phone number does not have a linked Seller Center Account?

1. Lỗi: This email/phone number does not have a linked Seller Center Account.
2. Vui lòng lưu ý rằng seller developer nên sử dụng tài khoản TikTok Shop seller center để xác minh và tài khoản người bán này phải vượt qua quá trình xét duyệt KYC/KYB trong seller center

8. Lỗi này có nghĩa là gì: Authorization failed?

Private App chỉ có thể được ủy quyền và liên kết với DUY NHẤT một cửa hàng (cửa hàng của chính người bán). Vui lòng tạo một App trong các danh mục khác không thuộc 「App developer / Seller inhouse developer / TikTok Shop Seller. Cửa hàng của chính người bán đề cập đến cửa hàng mà người bán đã liên kết tài khoản seller center với My Account - Category & Market - TikTok Shop Seller.

9. Tôi có một App trong danh mục ISV. Tôi có thể thay đổi danh mục App sang seller developer không?

Vui lòng đăng ký làm TikTok Shop seller developer. Tham khảo Seller developer onboarding guide.

10. Tôi có thể tích hợp với những API nào?

Danh sách API và tài liệu tham khảo.

11. Tôi có một app thuộc các danh mục khác, không phải 「App developer / Seller inhouse developer / TikTok Shop Seller」, tôi có bị ảnh hưởng không?

Không, bạn sẽ không bị ảnh hưởng.

12. Có thay đổi nào đối với các ủy quyền hiện có của tôi không?

Không, các ủy quyền vẫn còn hiệu lực cho đến khi token hết hạn hoặc ủy quyền của bạn bị hủy.

13. Tôi đã tạo một custom App khác để đảm bảo các cửa hàng mới có thể ủy quyền cho App, tôi nên làm gì với App hiện có?

App hiện có đề cập đến App được tạo trong 「App developer / Seller inhouse developer / TikTok Shop Seller」)

• Phương án A: bạn có thể duy trì hai App.
• Phương án B: bạn có thể di chuyển các ủy quyền trong quá khứ sang App mới. Để di chuyển, cửa hàng trong quá khứ cần ủy quyền lại cho App mới