Thanh toán - Lifecycle Rules (Payment)

Purpose

• Chuẩn hoá hành vi vòng đời gói: mua, nâng cấp/hạ cấp, credit, huỷ, thất bại thanh toán, bundle và hóa đơn.
• Bổ sung chi tiết vận hành cho các tài liệu Packages, Catalog, Checkout, Admin.

Active Scope Gate (DOL English Web V2)

• Active rule trong doc này chỉ áp dụng cho:
  • Monthly (auto-renew),
  • Annual 12 tháng (auto-renew theo năm),
  • One-time 3/6 tháng (non-renew).
• Các logic K12/Fixed-term/household là legacy ecosystem reference, không dùng làm baseline active cho DOL English Web V2.

Cycles & Credit

• Chu kỳ active: Monthly (auto-renew), Annual 12 tháng (auto-renew theo năm) và One-time Pass 3/6 tháng (không tự gia hạn).
• Không carry-over: credit dư của gói auto-renew (monthly/annual) mất khi hết kỳ; one-time hết hạn mất credit còn lại.
• Hết credit trong gói auto-renew: coi như nâng cấp credit/kỳ; thu phần chênh kỳ hiện tại, kỳ sau dùng giá mới, chu kỳ giữ nguyên.

Upgrade/Downgrade Rules

• Monthly: hạ gói hiệu lực kỳ kế tiếp; nâng gói hiệu lực ngay, tính tiền chênh lệch phần kỳ còn lại (prorate).
• One-time: không hỗ trợ downgrade/cancel refund giữa kỳ.
• Thay đổi credit: tăng áp dụng ngay với proration; giảm áp dụng từ kỳ sau.

Concurrent Packages (per Program)

• Không cho tồn tại song song 2 gói cùng chương trình trong cùng scope entitlement active.
• Monthly: chỉ được lên/xuống gói hiện có, không mua thêm gói mới cùng chương trình.
• One-time: nếu đang ở tier thấp và mua tier cao cùng scope, xử lý như nâng cấp theo policy active; không mở thêm bản one-time song song cùng scope.

Cancellation

• Subscription Monthly/Annual: huỷ chủ động; vẫn dùng tới hết kỳ đã trả tiền.
• One-time: tự hết hiệu lực khi hết kỳ; không có hành động huỷ; không auto-renew.

Refund Policy Baseline

• Không hỗ trợ self-serve refund trong active scope hiện tại.
• Refund được xử lý bởi support/manual policy theo lý do hợp lệ.
• Ngoại lệ fairness:
  • lỗi chấm AI do hệ thống sau khi đã charge credit -> auto-refund credit theo contract.

Payment Failure & Grace

• Lịch thu tự động:
  • monthly: theo ngày mua trong tháng,
  • annual: theo ngày mua hằng năm.
• Retry D0/D1/D3/D5/D7; grace 7 ngày.
• Trong grace: học bình thường, không cấp credit mới, hiển thị nhắc chưa thanh toán.
• Hết grace chưa thanh toán: gói bị huỷ, muốn dùng tiếp phải đăng ký lại.

Bundle Logic

• Gói cao nhất là gói chính; các gói còn lại được ưu đãi 10% tại thời điểm mua.
• Chỉ bundle lúc mua; sau đó quản lý gói độc lập.
• Huỷ gói chính: chọn gói cao tiếp theo làm gói chính.

Sequential Promotion (KM lẻ)

• Mua gói thứ 2 trong 7 ngày kể từ gói thứ 1: giảm 10%.
• Mua gói thứ 3 trong 7 ngày kể từ gói thứ 2: giảm 10%.
• Nếu gói chính bị huỷ: chọn gói mua tiếp theo làm gói chính để xét tiếp giảm.

Devices & Concurrency

• Hỗ trợ mua thêm slot thiết bị học đồng thời; cấu hình ở Payment Admin theo tier + add-on.
• Khi login vượt hạn slot:
  • không cấp phiên dài hạn ngay,
  • chuyển user sang màn quản lý thiết bị active để logout từ xa,
  • giải phóng đủ slot thì hoàn tất login tại chỗ.
• Tránh policy tự động “đá phiên cũ” không thông báo vì dễ gây mất phiên học đang diễn ra.

Invoicing

• Không nhập thông tin hoá đơn: dùng thông tin đăng ký mặc định.
• Sửa thông tin hoá đơn áp dụng từ kỳ sau (chỉ với gói tháng); One-time áp dụng ngay đơn hiện tại.

Trigger Points (liên quan nội dung)

• Bán gói lẻ/bundle: mở flow thanh toán với sản phẩm và giá tương ứng.
• Premium theo chương trình (ví dụ IELTS Reading Linear, IELTS Writing Correction, IELTS Speaking real test, IELTS Listening chép chính tả…): bật popup chọn gói trong chương trình (Lite/Pro; khoá học chỉ có trong Pro).
• Cần map nội dung kích hoạt cho từng trigger trong từng chương trình.

References

• ./PAY_Packages_Tiers.md
• ./PAY_Product_Catalog.md
• ./PAY_Checkout_Flows.md
• ./PAY_Admin_Console.md
• ./PAY_00_Overview.md

Change log

• 2026-02-27: Cập nhật lifecycle active: thêm Annual 12 tháng auto-renew, bỏ One-time 12 tháng; one-time chỉ còn 3/6.
• 2026-02-21: Bổ sung refund baseline cho active scope: no self-serve refund, support/manual-policy handling, và giữ ngoại lệ auto-refund credit khi AI system failure.
• 2026-02-20: Refactor về active scope DOL English Web V2: chu kỳ active Monthly + One-time 3/6/12, loại bỏ fixed-term/K12/household khỏi baseline triển khai, và đồng bộ switching policy với docs payment hiện hành.
• 2026-11-02: Khởi tạo lifecycle cho monthly và one-time 3/6 tháng, quy tắc credit không carry-over, nâng/giảm gói, grace thanh toán, bundle và KM tuần tự.
• 2025-12-09: Thêm fixed-term (học kỳ/năm) non-renewing cho Exam/K12/International, điều chỉnh upgrade/downgrade/concurrency/cancellation cho One-time/Fixed-term, và ngoại lệ K12 subject mix cho phép nhiều SKU môn + bundle.