Hoàn Tiền/docs
VI

Hoàn tiền TikTok Shop

Phâ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.

1. Giới Thiệu Giao Diện Cấu Hình

Bạn đăng nhập vào hệ thống quản trị Admin Panel, tìm chọn menu Cài Đặt Hệ Thống ở thanh menu bên trái, sau đó chọn tiếp tab Cấu hình TikTok Shop (hoặc truy cập trực tiếp qua liên kết: /admin/settings?tab=tiktok):

Giao diện cấu hình hoàn tiền TikTok Shop Hình 1: Chi tiết các mục thiết lập kết nối API và tỷ lệ hoàn tiền TikTok Shop

2. Thiết Lập Tỷ Lệ Hoàn Tiền (Cashback Rules)

  • Trạng thái Hoàn tiền TikTok Shop: Cho phép Bật (ON) hoặc Tắt (OFF) toàn bộ tính năng phân tích link sản phẩm và nhận hoa hồng hoàn tiền TikTok Shop. Khi tắt, người dùng sẽ không thể dán liên kết sản phẩm TikTok Shop ngoài trang chủ.
  • 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 TikTok Shop chi trả để hoàn lại cho khách hàng mua sản phẩm (F0).
    • Ví dụ: Nếu hoa hồng TikTok Shop chi trả là 100,000đ, bạn cài đặt tỷ lệ này là 70%, khách mua hàng sẽ nhận được 70,000đ hoàn tiền.
    • Nếu nhập giá trị là 0, hệ thống tự động hoàn tiền theo giá trị hoa hồng nhận về thực tế từ API sau khi trừ phí thuế.
  • Tỷ lệ khấu trừ hoa hồng (%): Ô cấu hình này chỉ xuất hiện khi tỷ lệ hoàn trả khách được cài đặt bằng 0. Dùng để tự động khấu trừ một khoản phần trăm phí sàn hoặc thuế thu nhập cá nhân (Ví dụ: nhập 10 để trừ đi 10% thuế TNCN trước khi trả cho khách hàng).
  • * Lưu ý: bạn nên tìm hiểu % chịu thuế thực tế mà bạn phải chi trả khi TikTok Shop 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.

3. Cấu hình Kết Nối API TikTok Shop (RioHub)

Để tự động lấy hình ảnh, tên sản phẩm và chuyển đổi liên kết affiliate TikTok Shop, website kết nối đến cổng API trung gian RioHub:

  • Trạng thái kết nối API: Cho phép Bật (ON) hoặc Tắt (OFF) việc lấy dữ liệu qua API.
  • Đường dẫn API (API URL): Địa chỉ máy chủ API của RioHub, mặc định là https://riohub.vn/api/v1.
  • TikTok Creator Username: Tên tài khoản TikTok Creator của bạn đã được đăng ký và kết nối thành công trên hệ thống RioHub.
  • RioHub API Key: Khóa bảo mật do RioHub cung cấp để xác thực quyền truy cập. Bạn nhập trực tiếp vào ô này.
Hướng Dẫn Kết Nối KOC/Creator & Lấy API Key Trên RioHub

4. Cấu Hình Dọn Dẹp Cache Sản Phẩm

  • Thời gian xóa sản phẩm cào ước tính (Giờ): Số giờ hệ thống lưu trữ thông tin của các sản phẩm bị lỗi cào (fallback, giá = 0). Hết số giờ này, hệ thống tự động xóa bản ghi lỗi để ép hệ thống cào lại sớm hơn, đảm bảo cập nhật thông tin chính xác ở lượt dán link tiếp theo. Mặc định là 24 giờ.
  • Thời gian xóa cache thông thường (Ngày): Số ngày lưu cache sản phẩm thông thường. Hệ thống sẽ tự động xóa các sản phẩm lưu tạm này nếu không có lượt tra cứu hoặc cập nhật mới sau số ngày cài đặt để giải phóng dung lượng cho cơ sở dữ liệu. Mặc định là 30 ngày.

5. Đối Soát & Tự Động Hoàn Tiền

  • Bắt buộc khớp tên sản phẩm: Cho phép Bật (ON) hoặc Tắt (OFF).
    • Bật (ON): Hệ thống đối soát bắt buộc tên sản phẩm khách mua thực tế phải khớp hoàn toàn với liên kết sản phẩm dán ban đầu thì mới duyệt đơn hoàn tiền.
    • Tắt (OFF): Khách hàng dán link sản phẩm A nhưng mua sản phẩm B (hoặc bất kỳ sản phẩm nào khác trong giỏ hàng đó), hệ thống vẫn phê duyệt đơn hoàn tiền cho họ.

6. Cấu Hình Lưu Ý Cashback & Mã Đơn Hàng

  • Nội dung lưu ý hiển thị ở kết quả tìm kiếm: Soạn thảo nội dung ghi chú (Ví dụ: "Đơn hàng hoàn tiền TikTok Shop được duyệt sau đối soát 15-30 ngày kể từ khi giao hàng thành công..."). Đoạn văn bản này sẽ hiển thị ngay dưới thẻ thông tin sản phẩm sau khi khách hàng dán link phân tích thành công tại trang chủ.
  • Tiền tố mã đơn hàng (Prefix): Ký tự viết liền không dấu đi kèm mã đơn hàng để bạn dễ nhận diện nguồn lưu lượng traffic (Ví dụ: TTS, DH, CASHBACK...).
  • Vị trí tiền tố: Chọn hiển thị tiền tố nằm ở Bên trái (Ví dụ: TTSxxxxxx) hoặc Bên phải (Ví dụ: xxxxxxTTS).
  • Số ký tự ngẫu nhiên: Độ dài chuỗi ngẫu nhiên sinh ra (giới hạn từ 4 đến 32 ký tự).
  • Kiểu ký tự ngẫu nhiên: Lựa chọn định dạng ký tự phù hợp (Chữ và số in hoa, Chữ và số thường/hoa, Chỉ số, Chỉ chữ in hoa, Chỉ chữ thường/hoa).

Chọn nút Lưu Lại ở góc dưới để hệ thống áp dụng các thay đổi cấu hình mới.

Hoàn tiền TikTok ShopVề đầ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.