Payment Transaction Case Mapping

Goals:

• When referencing something, show enough information to that level.
• Non-technical readers should understand immediately (prioritize names, minimize technical IDs).
• Include links to the correct pages for quick cross-checking.

General principles

• Prioritize displaying: Entity name + action + amount + status.
• Technical IDs (UUID, internal id) are secondary information only: place on a small line + include a copy button.
• When related transactions exist, display fully:
  • depositor
  • relatedTransactions
  • relatedWalletTransactions (especially the debit leg).

Standard page links

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

Mapping by case (operations version)

Case	What to show for non-tech users	Reference scope	Required page links
Player self top-up online	Player name, deposit amount, status, payment channel	Original payment transaction + payer leg (if funds debited from another tier)	/transactions/:id, /users/:id, corresponding owner page
Shop buys credit online	Shop name, credit received, amount paid	Payment transaction + wallet debit leg of the payer	/transactions/:id, /shops/:id
Agent buys credit online	Agent name, credit received, amount paid	Payment transaction + debit leg	/transactions/:id, /agents/:id
Super agent buys credit online	Super agent name, credit received, amount paid	Payment transaction + debit leg	/transactions/:id, /super-agents/:id
Agent collects cash deposit for shop (agent_cash, deposit)	"Which agent collected cash for which shop", cash amount, credit added	Agent (depositor), related payment transaction, agent wallet debit, shop wallet credit	/transactions/:id, /agents/:id, /shops/:id
Agent withdraws money/credit from shop (agent_cash, withdrawal)	"Which agent withdrew from which shop", cash returned, credit deducted	Shop (depositor), agent (recipient), shop wallet debit, agent wallet credit	/transactions/:id, /agents/:id, /shops/:id
Super agent collects cash deposit for agent (super_agent_cash, deposit)	"Which super agent collected cash for which agent", cash amount, credit added	Super agent (depositor), related payment transaction, super agent wallet debit, agent wallet credit	/transactions/:id, /super-agents/:id, /agents/:id
Super agent withdraws money/credit from agent (super_agent_cash, withdrawal)	"Which super agent withdrew from which agent", cash returned, credit deducted	Agent (depositor), super agent (recipient), agent wallet debit, super agent wallet credit	/transactions/:id, /super-agents/:id, /agents/:id
Admin cash funding/withdrawal for super agent	Admin action, target super agent, amount, transaction type	Payment transaction + corresponding wallet leg (credit/debit)	/transactions/:id, /super-agents/:id
Shop/Cashier add/deduct player credit	Shop/cashier name, player name, add/redeem action, amount	Wallet debit/credit legs (even without a payment transaction)	/shops/:id, /users/:id
Internal manual deposit	Player name, target game/provider, processing status	Payment transaction + reservation/release if applicable	/transactions/:id, /users/:id
Internal game withdrawal	Player name, game, amount, approval status	Payment transaction + debit status at request/approval	/transactions/:id, /users/:id
Rewards redemption webhook	Player name, reward amount, completion status	Payment transaction + credit leg to player wallet	/transactions/:id, /users/:id
Balance conversion/correction/reversal	Wallet owner, adjustment type, before/after amount	Full reference chain to source transaction	/transactions/:id + owner page

Required rules when references exist

1. Has depositor → show name + role + profile link.
2. Has relatedTransactions → show list + link to each transaction.
3. Has relatedWalletTransactions → show full from -> to, leg type, amount.
4. Prioritize highlighting debit first to identify "who paid".

Short display template (recommended)

• 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