User & Payment Management

This guide covers day-to-day player management, KYC review, withdrawal processing, and payment method configuration.

---

Table of Contents

1. Player list and search
2. Player detail view
3. Account actions
4. Wallet adjustments
5. KYC document review
6. AML alert review
7. Transaction ledger
8. Withdrawal approval queue
9. Payment methods configuration
10. Payment routing rules
11. Affiliate management
12. Daily operations checklist

---

1. Player list and search

URL: /admin/players

The player list shows all registered accounts. Use filters to find specific players:

Filter	Options
Search	Email, username, or name (partial match)
Registration date	Date range
Country / Jurisdiction	ISO country code
Account status	Active, Suspended, Banned
KYC status	Unverified, Pending, Approved, Rejected
VIP Tier	Filter by loyalty tier

Results are paginated. Click any row to open the player detail view.

---

2. Player detail view

URL: /admin/players/{id}

The player detail page is the primary support tool. It is organized into tabs:

Tab	Contents
Overview	Account info, wallet balance, status, registration details, country
Transactions	Full deposit/withdrawal/bonus/adjustment history
Game Rounds	Every bet placed: game, amount, outcome, timestamp, RTP verification
Bonuses	Active and completed bonus history with wagering progress
KYC	Uploaded documents and verification status
Limits	Self-imposed and admin-imposed deposit/wager/loss limits
Notes	Internal admin notes (never visible to the player)
Points	Loyalty points balance and transaction history

Overview tab

Shows:

• Account ID, username, email, registration date
• Country and jurisdiction assignment
• Current wallet balance
• Account status (active / suspended / banned)
• KYC verification level
• VIP tier and points balance
• Last login timestamp and IP

---

3. Account actions

Available from the player detail page via the Actions dropdown.

Action	Description
Suspend	Temporarily blocks login. Player cannot play, deposit, or withdraw.
Unsuspend	Restores a suspended account.
Ban	Permanently closes the account. Sets a self-exclusion flag. Irreversible via the UI.
Force Logout	Invalidates all active sessions immediately. Use when an account is suspected compromised.
Reset Password	Sends a password reset email to the player’s registered address.

All actions are logged in the audit trail with the admin’s identity, timestamp, and any notes provided.

---

4. Wallet adjustments

Use with caution — all adjustments are permanently logged.

Accessible from the player detail page → Overview tab → Adjust Balance.

Type	When to use
Credit	Goodwill gesture, error correction, manual bonus award
Debit	Clawback of erroneous credits, fraud recovery

Both operations require a reason note, which is stored against the player record and logged in the audit trail. Always document the business justification.

Wallet adjustments bypass the normal bonus wagering system. Use the Bonus Award function (Admin → Bonuses → Manual Award) if you intend to award bonus funds with wagering requirements.

---

5. KYC document review

URL: /admin/kyc

KYC dashboard metrics

Metric	Description
Total Pending	Documents awaiting a decision
Average Time-to-Decision	Mean time from submission to approve/reject
By Status	Count of pending / approved / rejected documents

Document review workflow

1. Click a pending review from the KYC queue.
2. The player’s uploaded documents open (ID front/back, proof of address, selfie if required).
3. Click Download to save a local copy if needed for compliance records.
4. Verify the document:

• Name matches the account registration name
• Document is not expired
• Document is not obscured, cropped, or altered
• Proof of address shows the registered address and is recent (typically within 3 months)

1. Click Approve or Reject.

• Rejected documents require a reason, which is automatically emailed to the player.

1. Approved players are automatically permitted to transact above KYC thresholds.

KYC thresholds

KYC requirements trigger based on deposit volume and are configured per jurisdiction in Admin → Jurisdictions. Example:

• Deposits below threshold: no KYC required
• Deposits above threshold: verified identity required before further deposits

---

6. AML alert review

URL: /admin/aml-alerts

The AML monitoring system automatically flags suspicious activity patterns.

Alert types

Alert Type	Trigger
Large Cash Transaction	Single deposit above configured threshold (default: $10,000)
Rapid Deposit Pattern	Multiple deposits within a short window (default: 5 deposits in 60 minutes)
High Wagering Velocity	Unusually high wager frequency compared to account history
Structuring	Deposits consistently just below the reporting threshold
PEP Match	Player name matches Politically Exposed Persons database

Alert severity levels: Low / Medium / High / Critical

Review workflow

1. Open an alert from the AML alerts list.
2. Review the associated transactions, player history, and source of funds.
3. Mark the alert as one of:

• Clear — no further action; document reason
• Escalate — refer to compliance team for enhanced review
• Freeze — suspend the player’s account pending investigation

1. Add a review note documenting your decision rationale.

All AML decisions are written to the immutable audit log. They cannot be edited after submission.

---

7. Transaction ledger

URL: /admin/finance

Full paginated history of all platform transactions.

Filters

Filter	Options
Transaction Type	Deposit, Withdrawal, Bonus, Adjustment, Transfer
Date Range	Start and end date
Currency	Per-currency filtering
Player	Filter by email or player ID
Status	Completed, Pending, Failed, Reversed

Export

Click Export to CSV to download the current filtered results. Useful for regulatory reporting, reconciliation, and audits.

Financial summary

The Summary tab shows aggregated KPIs for the selected period:

• Total deposits / withdrawals
• Gross Gaming Revenue (GGR)
• Bonus liability (outstanding wagering requirements)
• Active bonus count

---

8. Withdrawal approval queue

URL: /admin/withdrawals

All player withdrawals require manual approval before processing.

Queue columns

Column	Description
Player	Name and email (links to player detail)
Amount	Withdrawal amount in player currency
Method	Payment method (bank transfer, crypto wallet, etc.)
Requested At	Timestamp of the withdrawal request
KYC Status	Player’s current verification level
AML Flag	Whether the player has any active AML alerts

Approval workflow

1. Check KYC status — do not approve withdrawals for players who are unverified and above your KYC threshold.
2. Check AML flag — if flagged, route to the compliance team before approving.
3. Check withdrawal details — confirm payment details match the player’s verified identity.
4. Click Approve to process, or Reject with a written reason (reason is emailed to the player automatically).
5. For clean, low-risk withdrawals: use Batch Approve to process multiple withdrawals at once.

Withdrawal rejection

When a withdrawal is rejected:

• The player’s funds are returned to their wallet immediately
• The player receives an email with the rejection reason
• The action is logged in the audit trail

---

9. Payment methods configuration

URL: /admin/settings → Payment Methods tab

Configure which deposit and withdrawal methods are available to players.

Payment method fields

Field	Description
Name	Display name shown to players
Type	Deposit only / Withdrawal only / Both
Min Amount	Minimum transaction amount in platform currency
Max Amount	Maximum transaction amount in platform currency
Processing Fee	Fee charged to the player (percentage or fixed amount)
Enabled	Toggle visibility to players

Provider credentials

Payment providers require API credentials set in .env. See the Configuration Reference for the relevant variables for each provider (Stripe, PayPal, Coinbase Commerce, Mollie, bank transfer).

Adding a new payment method

1. Navigate to Admin → Settings → Payment Methods
2. Click Add Method
3. Select the provider from the dropdown
4. Enter the display name, limits, and fees
5. Toggle Enabled when ready to go live
6. Ensure the corresponding .env API credentials are set and config is cached

---

10. Payment routing rules

URL: /admin/settings → Routing Rules tab

Routing rules automatically direct payments to specific providers based on context:

Rule Condition	Example
Player country	Route UK players to Stripe
Transaction amount range	Use crypto for transactions above $5,000
Currency	Route EUR transactions through Mollie

Rules are evaluated in order. The first matching rule wins.

---

11. Affiliate management

URL: /admin/affiliates

Viewing affiliates

The affiliate list shows each affiliate’s:

• Referral count (total referred players)
• Commission earned (total, and pending payout)
• Commission rate (% of referred player GGR or deposits)
• Account status (active / paused)

Click an affiliate to view their full referral list and commission breakdown.

Processing commission payouts

1. Open the affiliate detail page.
2. Review the commission breakdown by referred player.
3. Click Process Payout to mark the outstanding balance as paid.
4. Record the payment method and reference number for the payout record.
5. The payout is logged in the audit trail.

Affiliate settings

Setting	Description
Commission Rate	Percentage of deposit or GGR paid as commission
Allowed Channels	Marketing channels the affiliate is permitted to use
Status	Active, Paused, or Terminated

---

12. Daily operations checklist

Every day

Task	Where
Review pending withdrawals	Finance → Withdrawals
Review KYC queue	Compliance → KYC Dashboard
Review AML alerts	Compliance → AML Alerts
Check Horizon queue health	/horizon or Admin → Dashboard
Review dashboard KPIs	Admin → Dashboard

Every week

Task	Where
Review EDD queue	Compliance → EDD
Review affordability alerts	Compliance → Affordability
Review affiliate payout balances	Affiliates
Export and archive transaction reports	Finance → Export

---

For settings, compliance configuration, and responsible gaming, see Admin: Settings & Compliance.