FS Example

Overview

Chức năng cho phép người dùng thanh toán học phí online trong LMS.

Functional Scope

• Tạo payment request.
• Chuyển người dùng sang payment gateway.
• Nhận callback kết quả.
• Cập nhật payment status.

User Roles

Role	Permission
Student/Parent	Tạo giao dịch thanh toán
Accountant	Xem báo cáo giao dịch

Process Flow

1. User chọn khoản học phí cần thanh toán.
2. User nhấn Thanh toán.
3. Hệ thống tạo payment request.
4. User được chuyển sang payment gateway.
5. Gateway trả callback.
6. Hệ thống cập nhật payment status.

Screen Specifications

Screen	Field	Behavior
Payment Detail	Amount	Read-only
Payment Detail	Pay Button	Enabled nếu status là Pending

Business Rules

ID	Rule
BR-001	Chỉ cho phép thanh toán khi payment status là Pending.

Validation and Error Handling

Case	Expected Handling
Gateway timeout	Giữ status Pending và cho phép kiểm tra lại.

Data Mapping

Source	Target	Notes
Gateway transaction_id	payment.transaction_id	Unique

Integration Requirements

API	Purpose
Payment callback	Nhận kết quả thanh toán

Permission Behavior

• Accountant chỉ xem báo cáo, không tạo giao dịch thay user.

Acceptance Criteria

• Khi gateway trả success hợp lệ, payment status chuyển thành Paid.

Open Questions

• Có cần retry callback không?