Docs

Players KYC Queue

Players KYC

This page is the central KYC review list for player identity-document verification.

Source route: /player-kyc

What This Module Is For

Use this queue when work starts from KYC status, not from an already opened player record.

Typical use cases:

  • review players waiting in KYC
  • separate editable admin_review cases from read-only cases
  • inspect rejection reasons and document identifiers
  • open one row in view or edit mode depending on permission and status

Permissions

The source menu exposes this module behind view_players_kyc.

Practical permission split:

  • view_players_kyc: can open the queue and view row details
  • manage_players_kyc: can update rows that are currently in admin_review

If manage_players_kyc is missing, the row opens in view mode only.

Statuses Visible In The Queue

The current source snapshot shows these KYC states:

  • pending
  • verified
  • rejected
  • admin_review
  • automation_kyc
  • kyc_withdrawal
  • kyc_withdrawal_bet

Operational reading:

  • admin_review is the main manual-work state for KYC managers
  • verified and rejected are final review outcomes
  • pending and automation-related states are usually inspection-first states unless your permissions and deployment add more actions
  • kyc_withdrawal and kyc_withdrawal_bet indicate KYC escalation tied to withdrawal controls

Queue Columns

The list is built around these fields:

  • Player ID
  • Email
  • Username
  • Document ID
  • User Document Verify
  • Date
  • action column

Use this table to decide whether you need only a read-only check or a manager update.

Row Action Rules

The current source behavior is strict:

  • if row status is admin_review and the user has manage_players_kyc, the action opens in edit mode
  • all other visible rows open in view mode when the user has view_players_kyc

This means the row does not become editable just because it is visible.

What Opens In The Modal

The queue action opens the KYC detail modal.

Visible information in the modal includes:

  • current KYC status
  • player ID
  • email
  • document ID or rejection reason
  • front document image
  • back document image
  • existing kyc_error_reason when present

What Is Editable

Editable only in manager mode and only for admin_review rows:

  • User Document Verify
  • Document ID when the outcome is not rejection
  • Reason when the outcome is rejected

Important source-backed behavior:

  • when status is changed to rejected, the document ID is cleared
  • when the modal is opened in view mode, status and reason fields are disabled
  • when the selected row was already admin_review, the status dropdown excludes pending

Save Behavior

When a manager updates an admin_review row:

  • the KYC update endpoint is called
  • the queue refetches after success
  • the form resets
  • server validation errors are returned to the modal fields

When To Use This Page vs Other Document Areas

Best Practice

  • treat admin_review as the main manual decision state
  • record clear rejection reasons so the next operator and the player-facing process are aligned
  • verify document images before changing final status
  • do not confuse KYC approval with capability toggles such as Can Login or Can Withdraw; those belong to the player detail workspace