Skip to main content
Là một Merchant, Tôi muốn xem rõ số dư khả dụng (Available) và số dư đang giữ (Pending Escrow) trong ví của mình, đồng thời thực hiện lệnh rút tiền về tài khoản MB Bank, Để tôi có thể quản lý dòng tiền kinh doanh một cách chủ động và minh bạch.

​
1. Điều kiện tiên quyết (Pre-conditions)

  • Merchant đã hoàn tất US-MER-35 (Onboarding) và đã khai báo tài khoản MB Bank hợp lệ ở US-MER-32.
  • Đang đăng nhập vào Merchant Dashboard.

​
2. Tiêu chí chấp nhận (Acceptance Criteria)

Hệ thống hiển thị trang Ví với 2 mục số dư rõ ràng:
  • Số dư khả dụng (Available Balance): Số tiền đã qua kỳ đối soát T+7+24h và sẵn sàng rút về ngân hàng. Hiển thị nút [Rút tiền].
  • Số dư đang giữ (Pending/Escrow Balance): Tổng tiền của các đơn đã Hoàn thành nhưng đang trong thời gian Hold 7 ngày. Hiển thị danh sách các khoản kèm thông tin “Còn X ngày release” cho từng khoản.
  • Lịch sử giao dịch (Transaction History): Danh sách tất cả lệnh rút tiền, khoản release tự động, khoản thu từ đơn hàng — phân trang, lọc theo khoảng thời gian.
Hệ thống kiểm tra phân hạng Shop (được Admin cấu hình ở US-ADM-13) để áp dụng hạn mức tương ứng:
  • Beginner: Số tiền rút tối thiểu mỗi lần và giới hạn số lần rút miễn phí/tháng. Nếu vượt số lần miễn phí, hệ thống thu thêm phí/lệnh.
  • Intermediate: Hạn mức rút cao hơn, thêm lượt rút miễn phí/tháng.
  • Pro: Không giới hạn số tiền, không giới hạn số lần rút, ưu tiên xử lý.
  • Merchant xem được phân hạng hiện tại và tiêu chí để lên hạng ngay trên màn hình Ví.
Merchant nhấn [Rút tiền], hệ thống hiển thị form:
  • Số dư khả dụng hiện tại (chỉ đọc).
  • Trường nhập Số tiền muốn rút — không được vượt Available Balance, không được thấp hơn ngưỡng tối thiểu theo tier.
  • Tài khoản ngân hàng đích (MB Bank đã đăng ký — chỉ đọc, để thay đổi phải vào US-MER-32).
  • Sau khi xác nhận: hệ thống tạo lệnh trạng thái WITHDRAWAL_PENDING, trừ số tiền tương ứng ra khỏi Available Balance ngay lập tức.

​
3. Quy trình xử lý (Business Rules)

1

Kiểm tra điều kiện hợp lệ

Hệ thống kiểm tra trước khi cho phép tạo lệnh:
  • Tài khoản MB Bank đã được xác minh hợp lệ (từ US-MER-32).
  • Số tiền rút ≥ ngưỡng tối thiểu theo tier.
  • Merchant không đang có lệnh rút tiền nào ở trạng thái WITHDRAWAL_PENDING hoặc WITHDRAWAL_PROCESSING.
2

Xử lý và chuyển khoản

  • Hệ thống (qua API MB Bank) thực hiện lệnh chuyển khoản về tài khoản đích.
  • SLA: Tiền về tài khoản ngân hàng trong 3–5 ngày làm việc kể từ khi lệnh được tạo.
  • Trạng thái lệnh cập nhật tuần tự: WITHDRAWAL_PENDING → WITHDRAWAL_PROCESSING → WITHDRAWAL_COMPLETED.
3

Thông báo kết quả

  • Thành công: Đẩy Push Notification và Email đến Merchant: “Lệnh rút [X đ] đã được xử lý. Tiền sẽ về tài khoản MB Bank trong 3–5 ngày làm việc.”
  • Thất bại: Đẩy thông báo lỗi, hoàn số tiền về Available Balance, yêu cầu Merchant kiểm tra lại thông tin tài khoản ngân hàng ở US-MER-32.