Chương trình Affiliate — Hoa hồng giới thiệu

Giới thiệu khách hàng → nhận 10% gói monthly / 16% annual hoa hồng. First-touch 60 ngày, payout ngày 15 hàng tháng. Routes: /affiliate/apply + /affiliate/dashboard + /affiliate/me.

Đăng ký

Đăng ký affiliate tại /affiliate/apply. Yêu cầu: xác minh email, MST cá nhân hoặc doanh nghiệp, số tài khoản ngân hàng nhận hoa hồng.

Điều kiện:

• Là tài khoản TKHQ đã verified email
• Đồng ý chính sách affiliate + anti-fraud
• Cung cấp kênh quảng bá (FB, blog, YouTube, agency, v.v.)
• Admin duyệt trong 24h làm việc

🔍

Trang đăng ký Affiliate — điền thông tin MST, kênh quảng bá, chờ duyệt

Mã + link

Sau khi duyệt, bạn nhận mã cá nhân + link tracking tại /affiliate/me.

Mã: JN-X4Y2K9
Link: https://tokhaihaiquan.com/?ref=JN-X4Y2K9

Cách quảng bá:

• Chia sẻ link — auto-attach UTM tracking
• Gửi mã cho khách hàng — họ nhập tại /checkout
• Cả 2 cách đều cùng commission

🔍

Trang /affiliate/me — mã cá nhân, link tracking, thống kê click

Attribution 60d

First-touch 60 ngày — user click link affiliate, hệ thống ghi cookie 60 ngày. Mọi đơn của user đó trong 60 ngày auto-credit affiliate đầu tiên.

Luồng attribution:

Click link → Cookie ref 60d → Đăng ký → Mua gói trong 60d → Credit commission

First-touch, không last-touch

Nếu user click 3 link affiliate khác nhau, chỉ affiliate đầu tiên (first click trong 60 ngày) được hoa hồng.

Hoa hồng

Commission ledger ghi mọi giao dịch — pending, cleared, paid, clawback.

KPI hoa hồng:

Trạng thái	Giá trị	Ghi chú
Pending	450.000 ₫	Đang chờ 7 ngày clearance
Cleared	2.150.000 ₫	Sẵn sàng payout
Lifetime	14.890.000 ₫	Tổng đã kiếm

Lịch sử commission:

Đơn	Khách	Gói	Hoa hồng	Trạng thái
ORD-...-0301	abc@...	Pro Annual	479.040 ₫	Pending
ORD-...-0287	def@...	Starter Monthly	19.900 ₫	Cleared
ORD-...-0190	ghi@...	Pro Monthly	49.900 ₫	Paid
ORD-...-0142	jkl@...	Pro Monthly	-49.900 ₫	Clawback (refund)

🔍

Dashboard Affiliate — hoa hồng pending/cleared, lịch sử đơn hàng giới thiệu

Thanh toán

Hoa hồng pending → cleared sau 7 ngày (window khách có thể refund). Sau khi cleared, payout vào ngày 15 hàng tháng nếu >= 500.000 ₫.

Timeline payout:

Sự kiện	Thời điểm	Trạng thái
Khách CK thành công	Ngày 1	Commission = PENDING
Window refund 7 ngày	Ngày 1–7	Khách có thể yêu cầu hoàn tiền
Status → CLEARED	Ngày 8	Sẵn sàng payout nếu đủ ngưỡng
Payout batch ngày 15	Ngày 15 hàng tháng	Bank transfer, status → PAID

Clawback nếu khách refund

Nếu khách refund trong 7 ngày clearance, commission bị clawback. Nếu refund sau 7 ngày (chính sách đặc biệt), clawback từ cleared balance.

Anti-fraud

Anti-fraud strict — bảo vệ hệ thống và affiliate thật.

Hành vi cấm:

• Self-referral (tự tạo tài khoản + dùng mã của chính mình)
• Cookie stuffing (force-inject cookie không có click thật)
• Fake account flood — tạo nhiều account spam
• Misrepresentation — quảng bá sai tính năng / giá

Hậu quả vi phạm

Cảnh báo lần 1 → suspend 30 ngày. Lần 2 → permanent ban + clawback toàn bộ commission cleared chưa payout.

Đảm bảo at-most-once commission

Mỗi đơn hàng chỉ tạo commission đúng một lần, ngay cả khi webhook SePay được gửi nhiều lần:

• Commission được tạo với purpose = "initial" kèm UNIQUE(referralId) constraint
• Nếu webhook trùng lặp → INSERT ... ON CONFLICT DO NOTHING → không tạo duplicate
• Chỉ áp dụng cho lần thanh toán subscription đầu tiên của khách hàng được giới thiệu

Subscription renewal có commission không?

Commission chỉ tính cho lần mua đầu tiên (initial subscription). Các lần gia hạn tiếp theo không sinh commission affiliate.

Cơ chế clawback

Khi khách hàng được giới thiệu yêu cầu hoàn tiền (refund), commission phải được thu hồi (clawback):

Công thức clawback:

clawbackAmount = min(commissionAmount, maxClawback - clawedBackVnd)

• maxClawback = tổng commission đã nhận từ referral này
• clawedBackVnd = tổng đã clawback trước đó (tích luỹ)
• Đảm bảo tổng clawback không vượt quá tổng commission đã nhận

Ví dụ:

Sự kiện	Commission	clawedBackVnd	Kết quả
Khách mua Pro Monthly	+49.900 ₫ (pending)	0	Commission = PENDING
Window clearance 7 ngày qua	49.900 ₫ (cleared)	0	—
Khách refund (sau 7 ngày, chính sách đặc biệt)	-49.900 ₫	49.900 ₫	Clawback từ cleared balance
Tổng còn lại	0 ₫	—	Không âm

Clawback từ cleared balance

Nếu refund xảy ra sau khi đã cleared (không phải trong window 7 ngày), clawback vẫn áp dụng nhưng trừ vào balance cleared chưa payout. Nếu đã payout rồi, affiliate phải hoàn trả trong kỳ thanh toán tiếp theo.

FAQ affiliate

Tôi giới thiệu người dùng đăng ký FREE — có commission không? Không. Commission chỉ tính khi khách mua gói có phí (Starter trở lên).

Khách mua annual plan — commission tính sao? Commission = 16% giá trị plan annual. Ví dụ: Pro Annual 2.994.000 ₫ → commission 479.040 ₫.

Nhiều affiliate cùng giới thiệu một khách — ai được? First-touch wins: affiliate đầu tiên đặt cookie (trong 60 ngày) được hoa hồng.

Commission pending bao lâu thì cleared? 7 ngày kể từ ngày khách thanh toán thành công.

Payout tối thiểu là bao nhiêu? 500.000 ₫. Dưới ngưỡng này, balance giữ nguyên sang tháng sau cộng dồn.