Payment Transaction Case Mapping

Mục tiêu:

• Reference tới đâu thì phải show đủ thông tin tới đó.
• Người non-tech đọc là hiểu ngay (ưu tiên tên, hạn chế ID kỹ thuật).
• Có link sang đúng page để kiểm tra chéo nhanh.

Nguyên tắc chung

• Ưu tiên hiển thị: Tên thực thể + hành động + số tiền + trạng thái.
• ID kỹ thuật (UUID, internal id) chỉ là thông tin phụ: đặt dòng nhỏ + có nút copy.
• Nếu có giao dịch liên quan thì hiển thị đủ:
  • depositor
  • relatedTransactions
  • relatedWalletTransactions (đặc biệt leg debit).

Link page chuẩn

• Transaction detail: /transactions/:id
• Agent profile: /agents/:id
• Shop profile: /shops/:id
• Super agent profile: /super-agents/:id
• User/Player profile: /users/:id

Mapping theo từng trường hợp (bản cho vận hành)

Trường hợp	Cần hiển thị cho non-tech	Cần show reference tới đâu	Link page cần có
Player tự nạp online	Tên player, số tiền nạp, trạng thái, kênh thanh toán	Payment transaction gốc + payer leg (nếu tiền bị trừ từ tier khác)	/transactions/:id, /users/:id, owner page tương ứng
Shop mua credit online	Tên shop, credit nhận, số tiền trả	Payment transaction + wallet debit leg của bên trả tiền	/transactions/:id, /shops/:id
Agent mua credit online	Tên agent, credit nhận, số tiền trả	Payment transaction + debit leg	/transactions/:id, /agents/:id
Super agent mua credit online	Tên super agent, credit nhận, số tiền trả	Payment transaction + debit leg	/transactions/:id, /super-agents/:id
Agent thu tiền mặt nạp cho shop (agent_cash, deposit)	“Agent nào thu tiền cho shop nào”, tiền cash, credit cộng	Agent (depositor), payment transaction liên quan, wallet debit của agent, wallet credit của shop	/transactions/:id, /agents/:id, /shops/:id
Agent rút tiền/credit từ shop (agent_cash, withdrawal)	“Agent nào rút từ shop nào”, tiền cash trả lại, credit trừ	Shop (depositor), agent (recipient), wallet debit shop, wallet credit agent	/transactions/:id, /agents/:id, /shops/:id
Super agent thu tiền mặt nạp cho agent (super_agent_cash, deposit)	“Super agent nào thu tiền cho agent nào”, tiền cash, credit cộng	Super agent (depositor), payment transaction liên quan, wallet debit của super agent, wallet credit của agent	/transactions/:id, /super-agents/:id, /agents/:id
Super agent rút tiền/credit từ agent (super_agent_cash, withdrawal)	“Super agent nào rút từ agent nào”, tiền cash trả lại, credit trừ	Agent (depositor), super agent (recipient), wallet debit agent, wallet credit super agent	/transactions/:id, /super-agents/:id, /agents/:id
Admin cash funding/withdrawal cho super agent	Admin thao tác, super agent đích, số tiền, loại giao dịch	Payment transaction + wallet leg tương ứng (credit/debit)	/transactions/:id, /super-agents/:id
Shop/Cashier cộng/trừ credit player	Tên shop/cashier, tên player, hành động add/redeem, số tiền	Wallet debit/credit legs (dù không có payment transaction)	/shops/:id, /users/:id
Manual deposit nội bộ	Tên player, game/provider đích, trạng thái xử lý	Payment transaction + reservation/release nếu có	/transactions/:id, /users/:id
Internal game withdrawal	Tên player, game, số tiền, trạng thái duyệt	Payment transaction + trạng thái debit tại request/approval	/transactions/:id, /users/:id
Rewards redemption webhook	Tên player, số tiền thưởng, trạng thái hoàn tất	Payment transaction + credit leg vào ví player	/transactions/:id, /users/:id
Balance conversion/correction/reversal	Chủ ví, loại điều chỉnh, số tiền trước/sau	Reference chain đầy đủ tới giao dịch nguồn	/transactions/:id + owner page

Rule bắt buộc khi có reference

1. Có depositor -> show tên + role + link profile.
2. Có relatedTransactions -> show danh sách + link từng transaction.
3. Có relatedWalletTransactions -> show đủ from -> to, loại leg, số tiền.
4. Ưu tiên highlight debit trước để biết “ai trả tiền”.

Mẫu hiển thị ngắn (đề xuất)

• Who paid: Agent · Claden Team (link)
• Who received: Shop · Claden S (link)
• Main transaction: Deposit $30.00 - Completed (link)
• Wallet legs:
  • Debit Agent Wallet: -300 credits
  • Credit Shop Wallet: +300 credits