Hướng dẫn này trình bày cách tạo Shopee App trên Shopee Open Platform Console: đăng ký Shopee Developer Account, tạo ứng dụng và chuẩn bị thông tin xác thực để kết nối cửa hàng Shopee với HexaSync Automation Engine. Sau khi tạo Shopee Connector trên HexaSync, bạn có thể dùng kết nối này cho các mục đích tích hợp như ERP, Customer Service hoặc Accounting, tùy nhu cầu doanh nghiệp.
Đã có Shopee Developer Account? Nếu tài khoản đã được phê duyệt và có quyền tạo App, bạn có thể bỏ qua Phần 1 và bắt đầu từ Phần 2.
Chuẩn bị trước khi bắt đầu
- Cửa hàng Shopee và tài khoản phù hợp với loại Shopee Developer Account đăng ký.
- Tài khoản Shopee Seller Center có quyền quản lý cửa hàng.
- Email, thông tin doanh nghiệp và giấy đăng ký kinh doanh.
- Mục đích tích hợp dự kiến để chọn App Category phù hợp.
Phần 1: Đăng ký Shopee Developer Account
Bước 1: Tạo tài khoản
- Truy cập Shopee Open Platform.
- Chọn Log In, sau đó chọn Sign up.
- Điền thông tin đăng ký theo yêu cầu.
- Hoàn tất xác minh email và thiết lập tài khoản.
Bước 2: Chọn loại Developer Account
- Nếu bạn là người bán tự phát triển hệ thống tích hợp, hoặc thuê bên thứ ba kết nối Shopee với hệ thống nội bộ, chọn Shopee Seller nếu đáp ứng điều kiện đăng ký.
Quan trọng: Không thể thay đổi loại Developer Account sau khi Submit hồ sơ. Hãy kiểm tra kỹ lựa chọn trước khi gửi.
Bước 3: Gửi hồ sơ đăng ký
- Cung cấp thông tin người bán và doanh nghiệp.
- Hoàn tất xác minh tài khoản Shopee Seller.
- Cung cấp giấy đăng ký kinh doanh.
- Gửi hồ sơ và theo dõi trạng thái xét duyệt.
Lưu ý: Thời gian xét duyệt Developer Account khoảng 3–7 ngày làm việc.
Phần 2: Tạo và cấu hình Shopee App trên Shopee Open Platform Console
Bước 1: Mở danh sách ứng dụng
- Truy cập Shopee Open Platform Console.
- Mở App Management.
- Chọn App List.
- Chọn Add New App.
Bước 2: Điền thông tin Shopee App
- Điền thông tin theo bảng dưới đây.
| Trường | Hướng dẫn |
|---|---|
| App Category | Chọn theo mục đích tích hợp, ví dụ ERP, Customer Service hoặc Accounting. |
| App Name | Đặt tên dễ nhận biết, ví dụ HexaSync Automation Engine. |
| App Service Region | Chọn khu vực ứng dụng phục vụ. |
| Description | Mô tả mục đích sử dụng ứng dụng. |
| Logo | Dùng logo phù hợp với ứng dụng. |
- Kiểm tra thông tin, sau đó chọn Submit.
Lưu ý về API Permissions: App Category ảnh hưởng đến các API module được cấp. Hãy xác định nhu cầu tích hợp trước khi tạo App. Quyền bổ sung ngoài phạm vi hiện có cần Shopee phê duyệt.
Bước 3: Cấu hình Test Redirect URL Domain
- Mở Shopee App vừa tạo và chọn Edit.
- Cuộn đến phần Authorization Information trên trang chỉnh sửa.
- Tìm trường Test Redirect URL Domain.
- Nhập chính xác địa chỉ bên dưới và lưu cấu hình.
https://app.hexasync.com/Quan trọng: Giữ nguyên dấu
/ở cuối URL. Có thể chỉnh sửa App khi đang review, nhưng việc chỉnh sửa có thể ảnh hưởng đến thời gian xét duyệt.
Bước 4: Chuẩn bị thông tin Sandbox
- Sau khi tạo App, bạn có Test Partner ID, Test Partner Key và Test Push Partner Key.
- Trong thời gian chờ App được review, bạn có thể kiểm thử trên môi trường Sandbox để xem có cần điều chỉnh thông tin App không.
Lưu ý: Không dùng Test credentials cho Production.
Bước 5: Thực hiện Go-Live
- Mở Shopee App trên Console và chọn Go-Live.
- Theo dõi trạng thái xử lý của Shopee.
Lưu ý: Thời gian xét duyệt Shopee App tham khảo khoảng 2–5 ngày làm việc.
Bước 6: Kiểm tra trạng thái Online
- Khi Shopee App có trạng thái Online, ứng dụng sẵn sàng để dùng trong môi trường Production.
Bước 7: Cấu hình Live Redirect URL Domain
- Mở Shopee App và chọn Edit.
- Cuộn đến phần Authorization Information.
- Tìm trường Live Redirect URL Domain.
- Nhập chính xác địa chỉ bên dưới và lưu cấu hình.
https://app.hexasync.com/Lưu ý: Test Redirect URL Domain và Live Redirect URL Domain đều dùng chính xác địa chỉ này, bao gồm dấu
/ở cuối.
Phần 3: Chuẩn bị thông tin kết nối HexaSync
Bước 1: Xác định môi trường kết nối
| Sandbox | Production |
|---|---|
| Test Partner ID | Live Partner ID |
| Test Partner Key | Live Partner Key |
| Test Push Partner Key | Live Push Partner Key |
| Test Redirect URL Domain | Live Redirect URL Domain |
Lưu ý: Sandbox chỉ dùng cho kiểm thử. Production yêu cầu Shopee App ở trạng thái Online (Bước 6 ở Phần 2).
Bước 2: Lấy Partner ID và Partner Key
- Mở App Management và chọn App List.
- Mở Shopee App cần kết nối.
- Sao chép Partner ID và Partner Key tương ứng với môi trường đã chọn.
Bước 3: Lấy Push Partner Key
- Mở App Management.
- Chọn Push Mechanism, sau đó chọn Set Push.
- Lấy Push Partner Key của môi trường cần kết nối.
Lưu ý:
- Push Partner Key là thông tin bắt buộc khi thiết lập Shopee Connector trên HexaSync.
- Sandbox dùng Test Push Partner Key, Production dùng Live Push Partner Key.
- Không chia sẻ công khai Partner Key hoặc Push Partner Key.
Phần 4: Kiểm tra thông tin trước khi chuyển sang HexaSync
- Shopee App đã được tạo và ở trạng thái Online nếu dùng Production.
- Có Partner ID và Partner Key tương ứng với môi trường kết nối.
- Có Push Partner Key tương ứng với môi trường kết nối.
- Đã cấu hình Redirect URL Domain tương ứng (Test hoặc Live).
- App có API permissions phù hợp với nhu cầu tích hợp.
Sau khi hoàn tất các bước chuẩn bị trên, hãy tiếp tục theo hướng dẫn bắt đầu với Shopee trên HexaSync.
Phần 5: Câu hỏi thường gặp
Đã có Shopee Developer Account thì có cần đăng ký lại không?
Không, nếu tài khoản đã được phê duyệt và có quyền tạo Shopee App. Bạn có thể bắt đầu từ Phần 2.
Nên chọn App Category nào?
Chọn theo mục đích tích hợp, chẳng hạn ERP, Customer Service hoặc Accounting. App Category ảnh hưởng đến các API module được cấp.
Có thể dùng Sandbox trước khi App Online không?
Có. Sau khi tạo App, bạn có thể kiểm thử trên Sandbox bằng Test credentials. Production yêu cầu Shopee App ở trạng thái Online.
Nếu cần thêm API permissions thì sao?
Các quyền bổ sung ngoài phạm vi hiện có cần được Shopee phê duyệt.
Test Partner Key có dùng cho Production không?
Không. Mỗi môi trường phải dùng thông tin kết nối tương ứng, xem bảng ở Phần 3 Bước 1.