Thanh toán - Recommendations (Payment)

Purpose

• Gợi ý chuẩn triển khai payment cho DOL English Web V2 theo active scope đã khóa.

Active Baseline (Do not drift)

• Scope: single-user, không household/parent-child.
• Tiers: Free, Pro, Pro Max.
• Cycles: Monthly + Annual (12m auto-renew) + One-time 3/6.
• Checkout hard gate: signed-in user + email đã verify.
• Với flow mua Pro/Pro Max hoặc đăng ký khóa học, phone contact là dữ liệu bắt buộc cho CS nhưng không cần verify.
• Blocker cho contact gate phải giữ nguyên lựa chọn plan/cycle/context và resume đúng bước checkout sau khi user bổ sung đủ dữ liệu.
• Goal/profile là optional, không phải hard gate ở checkout.
• Switching baseline:
  • upgrade: immediate + prorated charge,
  • downgrade: next cycle, no partial mid-cycle refund,
  • one-time: no mid-cycle downgrade/cancel refund.

Upgrade Entry Recommendations

• Locked AI feature luôn mở bằng quick popup trước checkout.
• Offer-set theo feature:
  • feature mở được bằng Pro -> hiển thị Pro + Pro Max;
  • feature chỉ mở bằng Pro Max -> chỉ hiển thị Pro Max.
• Nếu có 2 gói, bắt buộc user chọn gói trước khi đi tiếp.
• Khi có 2 gói, preselect mặc định gói tối thiểu đủ mở feature; user vẫn được đổi trước khi xác nhận.
• Luôn có link Xem chi tiết gói.
• Recommendation surface boundary:
  • recommendation phải ưu tiên item user làm được ngay (available-now),
  • locked item chỉ là teaser tùy chọn (không ép), tối đa 1 item/set khi inventory đủ,
  • teaser luôn hiển thị lý do khoá + gói tối thiểu cần để mở.

Offer Structure Recommendations

• Offer UI theo mechanism-first:
  • level 1: Auto-renew | One-time.
  • level 2 phụ thuộc cơ chế:
    • Auto-renew -> Monthly | Annual (12m auto-renew),
    • One-time -> 3 tháng | 6 tháng (non-renew).
• Khi user select cơ chế:
  • hiển thị note phương thức thanh toán khả dụng ngay dưới selector.
  • chỉ hiển thị option method phù hợp với cơ chế đang chọn.
• Không render đồng thời full danh sách method của cả hai cơ chế trên cùng state.
• Khi đổi cơ chế:
  • reset các lựa chọn method không còn hợp lệ,
  • giữ tier/context đang chọn nếu vẫn tương thích.

Cycle & Method Recommendations

• Monthly:
  • phương thức: Card + Momo.
  • thể hiện rõ auto-renew.
• Annual (12 tháng):
  • phương thức: Card + Momo.
  • thể hiện rõ auto-renew theo năm.
• One-time 3/6:
  • phương thức: Card + Momo + Bank QR/Chuyển khoản.
  • thể hiện rõ non-renew và ngày hết hạn.
  • 6 tháng dùng badge tiết kiệm so với 3 tháng.
• Queue overlap:
  • mua gói auto-renew (monthly/annual) khi one-time còn hạn -> auto-renew bắt đầu sau expiry.
• Visibility note:
  • monthly/annual methods chỉ hiện khi user đang ở nhánh Auto-renew.
  • one-time methods chỉ hiện khi user đang ở nhánh One-time.

UX Copy Recommendations

• Mechanism group labels:
  • Auto-renew: “Tự gia hạn”
  • One-time: “Mua một lần”
• Monthly label: “Tự gia hạn mỗi kỳ”.
• Annual label: “Tự gia hạn mỗi năm”.
• One-time label: “Không tự gia hạn”.
• Contact blocker copy: “Bạn cần email đã xác thực và số điện thoại liên hệ để hoàn tất thanh toán.”
• Nếu cần helper text: “Số điện thoại chỉ dùng để liên hệ chăm sóc khách hàng, không dùng để đăng nhập.”
• Post-upgrade success copy: “Nâng cấp thành công. Bạn có thể tiếp tục ngay tại màn hình hiện tại.”

Telemetry Recommendations

• Core events:
  • checkout_trigger_view
  • upgrade_offer_viewed
  • plan_selected
  • cycle_selected
  • contact_blocker_shown
  • checkout_payment_success
  • checkout_payment_fail
• Quality checks:
  • tỷ lệ rơi ở contact step,
  • tỷ lệ chọn Monthly vs Annual vs One-time,
  • tỷ lệ chuyển đổi từ locked-feature popup.

Scope Boundary Reminder

• KID flows (StudentCode/PIN, parent-child household, per-profile billing) không được dùng làm logic active cho DOL English docs.

Entitlement Downgrade Reminder

• Khi downgrade Pro Max -> Pro, giữ số dư AI credit nhưng lock usage cho feature không còn đủ entitlement.

Refund Recommendation Baseline

• Không bật self-serve refund ở phase hiện tại.
• Dùng support/manual-policy flow cho refund.
• Giữ auto-refund cho lỗi chấm AI hệ thống để bảo toàn fairness.

References

• ./PAY_Checkout_Flows.md
• ./PAY_Packages_Tiers.md
• ./PAY_00_Overview.md

Change log

• 2026-03-16: Làm rõ recommendation baseline: checkout yêu cầu signed-in user + email verified; phone là contact-only và không cần verify.
• 2026-03-02: Cập nhật recommendation theo baseline auth mới: bỏ gate xác thực theo số điện thoại; checkout dùng email verified + phone contact bắt buộc cho Pro/course.
• 2026-02-27: Thêm recommendation mechanism-first + dynamic method note theo lựa chọn để tránh show full payment methods cùng lúc.
• 2026-02-27: Cập nhật baseline chu kỳ: thêm Annual (12m auto-renew) và bỏ One-time 12; giữ one-time ở 3/6.
• 2026-02-22: Bổ sung recommendation/paywall boundary: recommendation ưu tiên available-now items; locked item chỉ là teaser tùy chọn có reason + minimum-eligible-plan.
• 2026-02-21: Thêm khuyến nghị default preselect minimum-eligible tier, blocker resume đúng step sau contact completion, và no-self-serve-refund baseline.
• 2026-02-20: Bổ sung khuyến nghị switching baseline rõ ràng (upgrade prorate ngay, downgrade kỳ kế tiếp, one-time không refund giữa kỳ) và copy post-upgrade continuity.
• 2026-02-20: Refactor recommendations về active scope DOL English Web V2; đồng bộ cycle Monthly + One-time 3/6/12 và boundary Product KID.
• 2026-02-18: Bổ sung required-data boundary recommendation cho checkout (no mandatory goal/learning profile).