Hoàn Tiền/docs
VI

Hoàn tiền Shopee

Trang này hướng dẫn bạn cách kết nối hệ thống với Shopee Affiliate API để lấy dữ liệu sản phẩm tự động, thiết lập tỷ lệ hoàn tiền cho thành viên, tỷ lệ khấu trừ và quản lý thông báo cashback.

1. Cấu Hình Tỷ Lệ Hoàn Tiền (Cashback Rules)

Bạn truy cập trang quản trị Admin Panel, chọn mục Cài đặt hệ thống và nhấn vào tab Cấu hình Shopee (hoặc truy cập trực tiếp đường dẫn: /admin/settings?tab=shopee):

Giao diện cấu hình Shopee Affiliate Hình 1: Thiết lập tỷ lệ hoàn tiền và kết nối API Shopee

Các tùy chọn tỷ lệ tài chính:

  • Shopee App ID (Affiliate ID): Nhập mã AppID định danh đối tác tiếp thị liên kết của bạn trên Shopee.
    💡 Cách lấy Affiliate ID: Bạn truy cập vào trang Thiết lập tài khoản Shopee Affiliate, tại đây bạn sẽ nhìn thấy mã Affiliate ID. Bạn sao chép mã này và dán vào ô Shopee App ID trên hệ thống để bắt đầu cấu hình liên kết.
  • Tỷ lệ hoàn trả khách (%): Tỷ lệ phần trăm hoa hồng trích ra từ tổng hoa hồng Shopee chi trả để hoàn lại cho khách hàng trực tiếp mua sản phẩm (F0). Ví dụ: Shopee chi trả hoa hồng 100,000đ, nếu bạn cài đặt tỷ lệ này là 70 thì khách hàng (F0) nhận được 70,000đ hoàn tiền.
  • Tỷ lệ khấu trừ hoa hồng (%): Tỷ lệ phần trăm tự động trừ đi trực tiếp trên tổng hoa hồng Shopee chi trả (ví dụ trừ thuế thu nhập cá nhân 10% của Shopee hoặc chi phí sàn tiếp thị) trước khi tính số tiền hoàn trả cho F0.
  • * Lưu ý về luồng phân chia hoa hồng: Khi bạn duyệt đơn hoàn tiền, hệ thống sẽ tính hoa hồng MLM 2 tầng F1 và F2 dựa trên số tiền thực tế F0 nhận (ví dụ F1 nhận 5% của 70,000đ = 3,500đ; F2 nhận 2% của 70,000đ = 1,400đ). Số tiền thực tế bạn (chủ shop) giữ lại sẽ là phần hoa hồng Shopee còn lại sau khi khấu trừ và chi trả hoàn tiền F0 cùng hoa hồng MLM F1/F2.
  • * Lưu ý: bạn nên tìm hiểu % chịu thuế thực tế mà bạn phải chi trả khi Shopee hoàn tiền, cá nhân, hộ kinh doanh, doanh nghiệp sẽ có mức thuế khác nhau, cân nhắc % khi hoàn cho user để tránh ảnh hưởng đến thu nhập của bạn.

2. Kết Nối API Shopee & Cache

  • Trạng thái API Shopee: Cho phép Bật/Tắt tính năng lấy dữ liệu sản phẩm tự động khi người dùng dán link Shopee ở trang chủ.
  • Đường dẫn API (API URL): Địa chỉ API trung gian của CMSNT để lấy thông tin sản phẩm: https://apishopee.cmsnt.co/api/v1/shopee/product.
  • API Key: Khóa bảo mật do CMSNT cấp để xác thực quyền lấy thông tin sản phẩm Shopee. Bạn cần truy cập https://apishopee.cmsnt.co/ đăng ký tài khoản và liên hệ CMSNT để duyệt tài khoản.
  • Thời gian Cache sản phẩm: Số giờ lưu trữ thông tin sản phẩm đã cào trong bộ nhớ đệm (Ví dụ: 24 giờ). Hết thời gian này, nếu có người dán link, hệ thống sẽ gọi API cào lại để cập nhật giá và ảnh mới nhất.
  • Bắt buộc khớp tên sản phẩm: Nếu bật, hệ thống sẽ đối soát tên sản phẩm khi đối soát đơn hàng hoàn tiền để tránh nhầm lẫn.

3. Chính Sách & Tiền Tố Mã Giao Dịch

  • Hoàn tiền đơn hàng tương lai (Cookie): Khi bật, nếu khách hàng mua thêm các sản phẩm khác trên Shopee trong thời gian cookie affiliate còn hiệu lực, hệ thống vẫn ghi nhận hoàn tiền cho họ.
  • Lưu ý Cashback: Soạn thảo nội dung cảnh báo hoặc lưu ý (Ví dụ: "Đơn hàng hoàn tiền Shopee được duyệt sau đối soát 30-45 ngày") hiển thị ngay sau khi khách dán link sản phẩm.
  • Tiền tố mã đơn hàng (Prefix): Ký tự đầu tiên của mã lượt nhấp dùng để đối soát (Ví dụ: ORDER).

Chọn nút Lưu Lại để hệ thống cập nhật các thay đổi.

Hoàn tiền ShopeeVề đầu trang
© 2026 Hoàn Tiền DocsPowered by CMSNT LTDTài liệu hướng dẫn sử dụng.
Giới thiệu hệ thốngĐây là trang tổng hợp hướng dẫn sử dụng chi tiết dành cho Quản trị viên (Admin) của hệ thống Platform Hoàn Tiền Mua Sắm Shopee (Cashback Platform).Quản lý menuChức năng này giúp Quản trị viên (Admin) tự do cấu hình, chỉnh sửa, gạt bật/tắt hiển thị và sắp xếp các liên kết điều hướng ở các vị trí khác nhau trên giao diện website Storefront một cách nhanh chóng và tự động.Bài viết BlogPhân hệ Blog cung cấp các công cụ thiết lập chuyên mục bài viết và soạn thảo bài viết. Giúp bạn đăng tải các chia sẻ kiến thức, tin khuyến mãi, mẹo mua sắm, tối ưu hóa nội dung chuẩn SEO để tăng lưu lượng truy cập tự nhiên.Vai trò & phân quyềnPhân hệ Quản lý vai trò và phân quyền (Role-Based Access Control - RBAC) giúp Quản trị viên (Admin) thiết lập, phân cấp và quản lý chi tiết các nhóm vai trò quản trị (như Super Admin, Nhân viên duyệt đơn, Kế toán, Hỗ trợ kỹ thuật...). Cơ chế này giúp bảo vệ thông tin tài chính nhạy cảm và kiểm soát chặt chẽ các hành động của từng tài khoản nhân viên.Đa ngôn ngữChức năng quản lý ngôn ngữ giúp bạn dịch thuật, chỉnh sửa câu chữ hiển thị và cấu hình hiển thị đa ngôn ngữ trên website storefront để tiếp cận nhiều đối tượng khách hàng ở các quốc gia khác nhau.Đa tiền tệChức năng quản lý tiền tệ giúp bạn thiết lập và kiểm soát các đơn vị tiền tệ giao dịch, định dạng hiển thị ký hiệu và cấu hình tỷ giá quy đổi tự động trên website.Quản lý thành viênChức năng quản lý thành viên giúp bạn theo dõi danh sách thành viên đăng ký, kiểm soát số dư ví khả dụng, điều chỉnh tiền thưởng/phạt và tra cứu lịch sử giao dịch/hoạt động của từng người dùng trên hệ thống.Trang tĩnhChức năng quản lý trang giúp bạn soạn thảo và xuất bản các trang thông tin độc lập trên website storefront (Ví dụ: Trang giới thiệu, Điều khoản dịch vụ, Chính sách bảo mật...).Hoa hồng giới thiệuHệ thống tiếp thị liên kết đa cấp giúp bạn thiết lập cơ chế chia sẻ hoa hồng giới thiệu 2 tầng (F1 và F2). Khi thành viên cấp dưới (F0) mua hàng và được duyệt hoàn tiền, người giới thiệu trực tiếp và gián tiếp sẽ nhận được thưởng.Thưởng điểm danhTính năng điểm danh giúp thu hút và giữ chân người dùng quay lại website hàng ngày bằng cách tặng thưởng tiền mặt khi điểm danh và cộng thêm quà tặng khi duy trì chuỗi ngày liên tiếp.Yêu cầu rút tiềnChức năng rút tiền giúp bạn thiết lập hạn mức tối thiểu, các loại phí giao dịch và hướng dẫn chi tiết hiển thị cho người dùng khi họ gửi yêu cầu rút số dư ví về tài khoản ngân hàng.Bảo mật hệ thốngThiết lập bảo mật hệ thống giúp ngăn chặn bot tự động đăng ký spam tài khoản ảo, bảo vệ thông tin cá nhân của người dùng và chống các cuộc tấn công rò rỉ dữ liệu.Voucher ShopeeHệ thống tự động cào và cập nhật các mã giảm giá, voucher khuyến mãi mới nhất từ Shopee về hiển thị ngoài trang chủ để tăng tỷ lệ người dùng nhấp mua hàng qua link affiliate của bạn.Hoàn tiền ShopeeTrang này hướng dẫn bạn cách kết nối hệ thống với Shopee Affiliate API để lấy dữ liệu sản phẩm tự động, thiết lập tỷ lệ hoàn tiền cho thành viên, tỷ lệ khấu trừ và quản lý thông báo cashback.Hoàn tiền TikTok ShopPhân hệ cấu hình TikTok Shop giúp bạn kết nối hệ thống với cổng API trung gian của đối tác RioHub. Cho phép người dùng dán liên kết sản phẩm TikTok Shop ngoài trang chủ để tự động phân tích thông tin sản phẩm, tính toán tỷ lệ cashback hoàn trả khách hàng, cấu hình thời gian xóa cache sản phẩm và tùy biến định dạng mã đơn hàng đối soát.Dọn dẹp & sao lưuChức năng dọn dẹp hệ thống giúp bạn tối ưu hóa cơ sở dữ liệu, giải phóng bộ nhớ cache ứng dụng, dọn các tệp ghi nhật ký lỗi lỗi và giải phóng dung lượng lưu trữ của máy chủ, giúp website hoạt động với hiệu năng mượt mà nhất.Quà tặng & đổi thưởngChức năng quản lý quà tặng cho phép bạn tạo ra các chương trình đổi quà (thẻ cào điện thoại, thẻ Garena, quà vật lý) cho các thành viên sử dụng số dư ví cashback hoặc coins tích lũy để quy đổi trực tiếp.Nhiệm vụ nhận thưởngTính năng Nhiệm vụ nhận thưởng giúp bạn tạo ra các nhiệm vụ khác nhau để khuyến khích thành viên thực hiện các hành động trên website (hoàn thiện hồ sơ, mời bạn bè, mua đơn hoàn tiền, điểm danh, rút tiền, lưu sản phẩm, hoặc thực hiện một hành động tùy chỉnh thủ công). Khi hoàn thành nhiệm vụ, thành viên sẽ nhận được số tiền thưởng (VNĐ) tương ứng cộng trực tiếp vào ví.Đối soát đơn hàngMục công cụ hệ thống giúp bạn kết nối Cookie Shopee để đồng bộ đơn hàng hoàn tiền tự động.Zalo & Telegram BotPhân hệ quản lý Bot tự động giúp chủ shop thiết lập các tài khoản Zalo Bot (thông qua Zalo Bot Platform) và Telegram Bot để tự động tương tác với người dùng. Khi người dùng dán link sản phẩm Shopee trực tiếp vào ô chat của Bot, hệ thống sẽ tự động chuyển đổi thành link tiếp thị liên kết chứa mã số định danh của họ để ghi nhận hoa hồng hoàn tiền khi họ mua sắm thành công.Trình dựng giao diệnHệ thống cung cấp một Trình dựng trang trực quan (Page Builder) giúp bạn tự do quản lý cấu trúc, thêm bớt, kéo thả thay đổi thứ tự và tùy chỉnh chi tiết nội dung các khối (block) hiển thị trên trang chủ Storefront. Bạn có thể dễ dàng theo dõi trực tiếp các thay đổi qua khung xem trước trước khi quyết định xuất bản chính thức.Cấu hình SMTP gửi emailHướng dẫn tạo mật khẩu ứng dụng Gmail và khai báo máy chủ SMTP để hệ thống gửi được email xác minh tài khoản, quên mật khẩu và thông báo hoàn tiền.