Operator guideEN

Players / KYC Status

KYC tab inside the player workspace for browsing user documents, checking third-party verification state, and approving, rejecting, or re-requesting documents.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this tab shows

Players / KYC Status is the player-level document and verification workspace. It shows submitted or requested documents, verification tags, provider verification state, the action controls used to approve or reject document items, and the separate used-cards document block for successful deposit cards.

When to use it

Use this tab when you need to:

  • review the player's uploaded verification documents
  • filter KYC documents by tag
  • inspect external verification status from Bynn or SumSub-related flows
  • approve, reject, cancel, or re-request a document
  • review previously used deposit cards and their document status

How to read it

The tab is centred on a paginated document table. Each row represents one user-document record and can include:

  • a document preview
  • tag chips
  • third-party verification state
  • operator/actionee metadata
  • one or more KYC actions based on the current status

Below the document table, the tab renders a second block: User success deposit cards. That block merges successful deposit-card history with stored card-document records so operators can see which cards already have submitted documents and open Update/View for that card.

Filters and controls

The player tab always scopes the document list to the selected player and returns every document status for that player. The generic KYC list can show a Status filter, but the player tab hides that filter and does not apply a pending-only default.

The Search by Tag box has a two-step state:

  • typing changes only the input value
  • pressing Enter or Apply Filters commits the tag search and reloads the list
  • Clear removes the committed tag search
  • clicking a visible tag chip immediately applies that tag as the search

Pagination controls the document table only. The used-card block is loaded as its own dataset and is not paginated by the document-table page selector.

Main actions

Pending document rows can be approved or rejected. Requested rows can be cancelled. Approved, cancelled, and other non-rejected rows can be re-requested. Rejected rows do not expose the re-request icon from this tab.

Add Document uploads a file for the player and creates a completed user-document record. It is not the same as requesting a missing document from the player.

The card Update/View modal belongs to the used-card document flow. Submitting card files can create or update linked pending KYC document rows, with the number of required files driven by the configured card-verification label.

Known caveats

  • 3rd Party Verification and 3rd Party Verification Date are provider-status summaries. They do not replace manual operator review of the actual document.
  • The real provider-backed path on this tab is Bynn. SumSub values visible on the list are currently controller-injected placeholder fields and should not be treated as confirmed provider evidence.
  • The action buttons depend on the document status. Pending records expose approve/reject actions, while requested or completed records expose a different action set.
  • The row-level Verify by 3rd Party icon is visible for bynn documents, but its list-level click handler is not wired to the backend yet. The working Bynn submission flows currently live in the approval modal and the manual Bynn verification modal.
  • Bynn-style dossier/report links appear only for documents where that provider context exists.
  • Download filenames and Bynn submission references use the configured brand name when that setting exists.
  • User success deposit cards is a separate merged dataset. It is built from successful deposit transactions plus UserCardsDocuments, so card rows can exist in required state even when no card-document record has been submitted yet.
  • The card-document Update/View modal saves through the card-document flow; it is not part of the main approve/reject document flow.
  • Cancelling a re-requested document returns that row to the approved state instead of deleting the historical document.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Columns14 topicsOpen details

Document ID

Internal identifier for one user-document record.

Group
document_table
Data Type
integer

User ID

Links the document row back to the owning player.

Group
document_table
Data Type
integer

Document Name

Document type, uploaded filename, or provider identifier attached to the row.

Group
document_table
Data Type
string

Preview Document

Opens the latest uploaded file URL for visual review when a file is present and the row is not represented only by a Bynn dossier context.

Group
document_table
Data Type
media

3rd Party Report

Resolves and opens the external Bynn dossier/report when the row belongs to the Bynn document flow and a dossier id exists.

Group
document_table
Data Type
external-link

Tags

Player tags attached to the document row for review context and tag filtering.

Group
document_table
Data Type
string-list

Reason

Request, re-request, rejection, provider-submission, or operator-upload note shown for the row.

Group
document_table
Data Type
string

3rd Party Verification

Combined provider chip. Bynn is the confirmed provider signal on this tab; SumSub list values are currently placeholder display fields.

Group
document_table
Data Type
enum

3rd Party Verification Date

Provider timestamp selected from Bynn first, then placeholder SumSub date when Bynn date is unavailable.

Group
document_table
Data Type
datetime

Updated At

Last update time for the document row.

Group
document_table
Data Type
datetime

Actionee

Operator or system actor saved on the latest document action.

Group
document_table
Data Type
string

Action Performed At

Timestamp for the most recent document action.

Group
document_table
Data Type
datetime

Status

Workflow chip inside the Action cell. It controls whether approve, reject, cancel, or re-request actions are available.

Group
document_table_action_cell
Data Type
enum

Action

Row action group for download, provider actions, history, approve, reject, cancel request, and re-request.

Group
document_table_action_cell
Data Type
action-set
Filters3 topicsOpen details

Search by Tag

Text the operator is currently typing. It does not affect the list until Enter, Apply Filters, or a tag chip commits it.

Type
text
Placeholder
Search by tag...

Active tag filter

The tag text actually sent into the document list reload. Clear removes this value and returns the list to the unfiltered player scope.

Type
state

Status

Status narrowing for the generic KYC list. It is intentionally not shown on the player-scoped KYC Status tab, which loads all statuses for the selected player.

Type
select
Visibility
generic KYC list only
Default
Pending on the generic list; hidden on the player tab
Options
0: Value: 0 | Label: Pending | 1: Value: all | Label: All statuses | 2: Value: 1 | Label: Approved | 3: Value: 2 | Label: Rejected | 4: Value: 3 | Label: Canceled | 5: Value: 4 | Label: Requested
More help

Related pages

Players / Banking

Banking tab inside the player workspace with transaction filters, a paginated banking grid, analytics cards, CSV export, and automatic-withdrawal availability.

Players / Detail Workspace

Main player workbench at `/player/[playerId]` with tabbed sections, player-level actions, and modal-based operator workflows.

Players / Fraud Detection

Fraud-detection tab inside the player workspace with MaxMind risk assessment, related fraud-account reports, IP analysis, and Identity Graph filtering.

Players / Game Report

Per-player game or provider report inside the player workspace, filtered by date option and grouped either by game or by provider.

Players / Inbox

Inbox tab inside the player workspace for reviewing delivered notifications, filtering by read state or notification type, and resending or soft-deleting message deliveries.

Players / KPI Summary

Grouped player-level KPI snapshot inside the player workspace, covering player info, deposits, withdrawals, casino totals, bonus cost, and predictive metrics.