Thanh toán - Product Catalog (Payment)

DomainsDOL EnglishUX880 words4 min read

active

Purpose

Chuẩn hóa danh mục sản phẩm active của DOL English Web V2 để checkout, entitlement, và báo cáo không bị lệch giữa các tài liệu payment.

Account model active: single-user.
Tier taxonomy cho self-study: Free, Pro, Pro Max.
Cycle active:
- Monthly (auto-renew),
- Annual 12 tháng (auto-renew theo năm),
- One-time 3/6 tháng (non-renew).
Entitlement boundary:
- Pro/Pro Max dùng cho quyền luyện tập và feature subscription.
- Khóa học mua lẻ (a la carte), không bị thay thế bởi subscription tier.
Out-of-scope trong baseline active:
- household/parent-child billing,
- StudentCode/PIN,
- K12 subject mix,
- fixed-term semester/year products.

Program Subscription Packages
- SKU theo program + tier (Pro/Pro Max) + cycle (Monthly hoặc Annual hoặc One-time 3/6).
- Dùng để mở entitlement subscription trong self-study.
AI Credit Top-up
- SKU top-up credit cho feature AI theo policy entitlement hiện hành.
- Charge-once theo scoring job/result; mở lại result đã chấm không trừ thêm.
Course A La Carte
- SKU khóa học mua lẻ theo program/course.
- Hoạt động song song với subscription, không bắt buộc phải có Pro/Pro Max.
On-demand Upgrade Entry
- Đây là entry policy (không phải product family độc lập):
  - feature mở được bằng Pro -> cho chọn Pro + Pro Max,
  - feature chỉ mở bằng Pro Max -> chỉ hiện Pro Max.

Pricing key:
- programCode,
- tier,
- billingCycle,
- durationMonths (3/6 cho one-time; 12 cho annual),
- currency (VND mặc định).
Savings cue:
- 6 tháng so với 3 tháng.
Overlap:
- Nếu one-time đang active rồi mua monthly cùng scope, monthly queue tới sau expiry one-time.
Switching:
- upgrade tier cao hơn: hiệu lực ngay + prorated charge phần chu kỳ còn lại,
- downgrade tier thấp hơn: hiệu lực kỳ kế tiếp, không hoàn tiền giữa kỳ,
- one-time: không có downgrade/cancel refund giữa kỳ.
Contact gate:
- checkout yêu cầu email đã verify.
- flow mua Pro/Pro Max và đăng ký khóa học yêu cầu số điện thoại liên hệ phục vụ CS.

Offer structure mặc định ở checkout/popup:
- level 1: Auto-renew | One-time.
- level 2:
  - Auto-renew -> Monthly | Annual (12m),
  - One-time -> 3 tháng | 6 tháng.
Method visibility by mechanism:
- Auto-renew -> card|momo,
- One-time -> card|momo|bank_transfer.
UI policy:
- không hiển thị đồng thời toàn bộ cycle/method từ cả 2 cơ chế.
- note phương thức khả dụng phải đi theo mechanism đang chọn.
Eligibility policy:
- tier offer-set (Pro|Pro Max) vẫn theo feature unlock eligibility hiện hành.

Mọi SKU payment active gắn theo user account (không per-profile billing trong DOL English Web V2).
Không có khái niệm parent chọn child profile trong checkout active.
Billing history và credit ledger gắn theo user account.

Core:
- skuId,
- programCode,
- productFamily,
- tier (pro|pro_max|topup|course),
- billingCycle (monthly|annual|one_time),
- durationMonths (3|6 cho one_time; 12 cho annual),
- price,
- currency.
Lifecycle:
- autoRenew (true cho monthly/annual, false cho one-time),
- paymentMethodsAllowed:
  - monthly/annual: momo|card,
  - one-time: momo|card|bank_transfer.
Entitlement:
- entitlementScope (self_study|course),
- upgradeEligibility (pro|pro_max_only),
- creditConfig (nếu SKU có credit).
Visibility:
- visibility (public|hidden|internal),
- effectiveDate,
- endDate (optional).

Subscription (Pro/Pro Max):
- mở các feature self-study theo tier.
AI Top-up:
- tăng quota dùng feature AI theo entitlement hiện tại.
Course A La Carte:
- mở quyền trong course context theo gói khóa học đã mua.
Cross-context:
- Course context theo course entitlement.
- Self-study context theo subscription entitlement.
- Same-item exception áp dụng theo rules đã chốt ở discovery.

Những logic legacy từng xuất hiện trong các bản tài liệu cũ (fixed-term, K12 subject mix, household per-profile billing) không còn là baseline active cho DOL English Web V2.
Nếu cần tái kích hoạt các logic này cho sản phẩm khác, phải mở DEC mới trước khi đưa vào active docs.

2026-03-02: Cập nhật contact gate theo baseline auth mới: email verified là điều kiện auth, phone là contact bắt buộc cho Pro/course.
2026-02-27: Bổ sung contract trình bày offer ở checkout: mechanism-first + dynamic method visibility theo mechanism được chọn.
2026-02-27: Cập nhật cycle taxonomy: thêm annual auto-renew (12 tháng), bỏ one-time 12 tháng, giữ one-time ở 3/6.
2026-02-20: Refactor toàn bộ catalog theo active scope DOL English Web V2 (single-user, monthly + one-time 3/6/12, no household/fixed-term/K12 trong baseline active).
2026-02-19: Đồng bộ entitlement course-vs-subscription và fairness của AI credit usage.