← Tất cả tích hợp

Kết nối Shopee với omniVN

Có thể kết nối

Nhấn Connect, đăng nhập tài khoản chính của shop Shopee, nhập OTP và xác nhận ủy quyền. Không dán partner key hay token.

Kết nối ShopeeTạo tài khoản và làm theo hướng dẫn bên dưới — dùng thử 14 ngày.

connectable: OAuth qua Partner app của omniVN. Connected = shop token + shop_id.

Giới hạn hiện tại

Những điểm này ảnh hưởng đến khả năng kết nối hoàn chỉnh.
  • Ủy quyền hết hạn theo thời hạn người bán chọn (≤365 ngày) — cần Connect lại.
  • Không dán credential trên UI để vượt cổng. Shopee Ads chưa hỗ trợ.

Tổng quan

Shopee Open Platform dùng OAuth. Mỗi workspace kết nối qua Partner app (partner_id / partner_key) của chính doanh nghiệp, đăng ký trên Shopee Open Platform; Shopee duyệt đăng ký trong vài ngày làm việc. omniVN hướng dẫn đăng ký và lưu Partner app cho workspace (liên hệ omniVN qua nút “Book onboarding help” trên trang Shopee); sau đó người bán chỉ cần ủy quyền shop. Sau khi ủy quyền, omniVN đổi code lấy access token + shop_id phía máy chủ. Kết nối chỉ được coi là Connected khi đã có shop token và shop_id.

Điều kiện trước khi bắt đầu

  • Tài khoản chính (main account) của shop Shopee — tài khoản phụ (sub-account) không ủy quyền được.
  • Điện thoại nhận OTP của shop.
  • Trong omniVN: quyền kết nối kênh trên workspace (channels.connect).

Các bước lấy credential

1. Nhấn Connect trong omniVN

Vào Integrations → Shopee và nhấn Connect. omniVN mở trang ủy quyền của Shopee (open.shopee.com/auth).

2. Đăng nhập tài khoản shop và nhập OTP

Đăng nhập bằng tài khoản shop (nếu đang ở tài khoản phụ, chọn Switch to Sub Account để chuyển sang tài khoản chính), rồi nhập mã OTP gửi về điện thoại.

Màn đăng nhập shop khi ủy quyền ứng dụng
Màn đăng nhập shop khi ủy quyền ứng dụng · Shopee Open Platform

3. Xác nhận ủy quyền và chọn thời hạn

Nhấn Confirm Authorization và chọn thời hạn ủy quyền (tối đa 365 ngày; chọn dài nhất để tránh phải kết nối lại sớm). Tài khoản chính quản lý nhiều shop sẽ tick các shop cần kết nối.

Nút Confirm Authorization trên trang ủy quyền Shopee
Nút Confirm Authorization trên trang ủy quyền Shopee · Shopee Open Platform

4. Quay lại omniVN

Shopee chuyển về omniVN kèm code (dùng một lần, hết hạn 10 phút). omniVN đổi code lấy token và shop_id; trang Shopee trong omniVN hiện trạng thái kết nối.

Ánh xạ credential với omniVN

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.
Field omniVNTên trong tài liệu officialBắt buộcLấy từ đâu
Partner IDpartner_idBắt buộcoperator_managed

The workspace's own Shopee partner app, sealed per org by an omniVN operator. Not pasted on Connect UI.

API Partner Keypartner_key / api_partner_keyBắt buộcoperator_managed

Sealed in the workspace's org app config (secret store), never deployment env. Not pasted on Connect UI.

Shop IDshop_idBắt buộcoauth_authorization

Bắt buộc cho Connected (cùng accessToken). Partner alone không đủ.

Access Tokenaccess_tokenBắt buộcoauth_authorization

Shop token trong secretRef. Connected = shop token + shop_id; empty/error ≠ Connected.

partnerId / partnerKey → Partner app của chính workspace, operator omniVN seal vào cấu hình app của org; người bán không nhập trên UI. shopId / accessToken → có sau OAuth, lưu secret store; bắt buộc cho Connected.

Vòng đời token

Access token sống 4 giờ; refresh token 30 ngày, dùng một lần cho mỗi shop — omniVN tự làm mới. Bản thân ủy quyền hết hạn theo thời hạn người bán chọn (tối đa 365 ngày); khi đó phải Connect lại.

Lỗi thường gặp

Connect báo PROVIDER_CONFIGURATION_INVALID

Workspace chưa có Partner app Shopee được seal, hoặc deployment thiếu OAUTH_CALLBACK_BASE_URL. Liên hệ omniVN — không dán partner key trên UI.

Shopee báo domain của redirect_uri không khớp Redirect URL Domain

Redirect URL Domain của Partner app chưa khai báo đúng miền callback của omniVN (việc của operator).

Không ủy quyền được bằng tài khoản phụ

Chỉ tài khoản chính của shop mới ủy quyền được ứng dụng.

UI không Connected sau OAuth

Cần cả shop token và shop_id. Dữ liệu rỗng hoặc lỗi không được coi là Connected.

Nguồn chính thức

Shopee Open Platform - Authorization Guide
open.shopee.com·Cần render JS·Đã kiểm chứng 2026-09-26
Shopee Open API - get_access_token
open.shopee.com·Cần render JS·Đã kiểm chứng 2026-08-29