Operator guideEN

Transactions / Failed Deposit

Triage grid for failed deposit rows, provider failure reasons, normalized error groups, raw detail inspection, and CSV export.

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 Surface Shows

Transactions / Failed Deposit is the triage queue for deposit attempts that did not complete successfully.

The page uses the shared banking transaction data path, but it starts with a failed-status default and renders failed-deposit-specific columns on top of those rows: provider failure reason, normalized error group, provider status details, tags, and raw More Info payloads.

How To Read It

Use this page when the operator question is:

  • why a deposit failed
  • which provider or method was involved
  • whether the failed reason is already grouped
  • which player/tag cohort is affected
  • what raw provider detail exists for escalation

The most important columns are:

  • Transaction Status, which is provider-status text when the status resource has a matching row status id.
  • Failed Reason, which is the visible row-level reason for the failed deposit.
  • Error Group, which is the normalized group joined from the failed-deposit reason tables.
  • User Tags, which can be clicked to filter the queue.
  • Action, which shows More Info only when the row has extra details.

Filters That Change The List

The filter form affects the table and CSV export:

  • Search player searches actionee email text. If the submitted value is numeric, it can also match transaction banking id or target/user id.
  • Currency filters by transaction currency code.
  • Type filters by transaction type while keeping the failed-status default.
  • Search by tag is a case-insensitive contains match over user tags.
  • Date start and Date end bound the transaction creation-time window.

Important: Search player does not currently search the Full Name column on this shared banking endpoint.

Row Actions

Clicking the email opens the selected player profile. It does not change the failed deposit row.

Clicking a user tag writes that tag into Search by tag and submits the filter form. The row shows the first tag and a count chip for additional tags; the tooltip can expose the remaining tags.

More Info opens the shared read-only detail modal when the row has raw/provider details. It does not retry the deposit, change status, or edit the error group.

Failed Reason And Error Group

Failed Reason is the row-level display reason. Carouseller rows with provider details show processor and real-processor messages; other rows use the generic banking error description.

Error Group is the normalized grouping bucket joined from failed-deposit error reason and error group tables. This list only displays the group name. Group maintenance happens on the separate Failed Deposit Error Groups surface.

Export Behavior

Download CSV exports the current failed-deposit query when the visible list has at least one row. It uses the active filters, bypasses visible-page pagination, and follows the shared banking export path.

The export can include fields that are not visible table columns. Created and Updated timestamps are converted into the browser timezone supplied by the export request, while the visible table Date column is rendered in UTC.

Known Caveats

  • Transaction Status can be blank if the provider status resource does not contain the row's status id.
  • Error Group is read-only on this list; edit groups on Failed Deposit Error Groups.
  • CSV export is shared with Banking, so fallback file naming and exported fields can look broader than the visible Failed Deposit table.
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.

Calculations11 topicsOpen details

Failed rows only

The page is failed-deposit focused because it initializes the shared banking query with failed status.

Formula
Frontend sends default `status = '3'`; backend maps numeric status 3 through the shared banking transaction status filter and returns matching failed transaction rows.

Search player

Finds failed-deposit rows by email text or numeric identifiers.

Formula
Backend matches actionee email with case-insensitive contains. If the submitted value is numeric, it can also match transaction banking id or target/user id.

Currency

Narrows failed-deposit rows by currency code.

Formula
Backend applies an exact currency code condition when the submitted code has at least three characters.

Type

Narrows failed-deposit rows by transaction type.

Formula
Backend ignores All/empty values and otherwise applies exact transaction type equality.

Date start / Date end

Limits failed-deposit rows by transaction creation time.

Formula
Frontend sends formatted dates and browser timezone; backend applies the date filter against TransactionBanking creation time.
Timezone Basis
Table Display: Date column is rendered as UTC with seconds. | Csv Export: Created and Updated timestamps are converted from UTC into the browser timezone supplied by the export request.

Search by tag

Narrows failed-deposit rows by user tags.

Formula
Lowercase contains match over each text value inside the joined user's tags array. Clicking a visible tag chip or tooltip tag writes the clicked tag into this filter and submits the table query.

Transaction Status

Shows provider status text for Carouseller-style rows when the resource has a matching status id.

Formula
Frontend looks up the row `moreDetails.status_id` in resource key `transactions.carouseller.statuses` and renders `statusId - status - description` when a match exists.
Missing Value Behavior
Blank cell when the resource or matching status id is absent.

Failed Reason

Shows the row-level payment failure reason used for triage.

Formula
Frontend prefixes the provider in brackets when present. For Carouseller rows with `moreDetails`, it renders processor message plus real processor message. Other rows render the generic banking error description.

Error Group

Shows the normalized error group joined to the failed deposit reason.

Formula
Backend joins `transaction_bankings.failed_reason_id` to `failed_deposit_error_reasons.error_reason_id`, then joins that reason's `error_group_id` to `failed_deposit_error_groups.error_group_id`; the grid displays the returned group name or `-`.

More Info

Shows raw/provider details only when the row carries extra details.

Formula
Frontend renders the More Info action only when `moreDetails` exists on the row.

CSV export scope

Exported rows match the current failed-deposit query but are not limited to the visible page.

Formula
The export branch reuses the shared banking query, sets csvDownload=true, removes normal pagination, converts Created and Updated timestamps to the supplied browser timezone, and appends productPrefix metadata.
Settings Dependency
system-settings.productPrefix
Notes2 topicsOpen details

Failed Deposit Error Groups is the editing surface for group definitions and assignments; this list only displays joined group names.

The page uses the shared banking transaction read/export path, so some exported fields can be broader than the visible failed-deposit columns.

Columns13 topicsOpen details

ID

Banking transaction row identifier.

Email

Player email attached to the failed deposit row; clicking it opens the player profile.

Full Name

Player full name copied onto the banking transaction row.

Amount

Failed deposit amount formatted with the row currency.

Data Type
amount

Transaction Status

Carouseller status text rendered from the core resource when the row contains a matching provider status id.

Display Rule
The page renders `statusId - status - description` when the resource contains the row status id.
Caveat
Rows without matching `moreDetails.status_id` resource content can show a blank status cell here even though the source row status is still failed.

Payment provider

Payment provider reported on the failed banking transaction.

Method

Payment method reported or resolved for the failed transaction.

Caveat
The shared source can apply fallback method resolution for specific withdrawal providers, but this failed-deposit page usually displays deposit-side method text.

Failed Reason

Row-level failure reason shown for triage.

Display Rule
Carouseller rows with details show provider label plus processor and real processor messages; other rows show the generic banking error description.

Error Group

Normalized failure bucket joined from failed-deposit error reason and error group tables.

Display Rule
Shows `-` when no error group is joined.
Caveat
Error groups are edited on the separate Failed Deposit Error Groups surface, not in this list.

Currency

Currency code for the failed deposit amount.

Date

Failed transaction creation timestamp rendered in UTC with seconds.

Timezone Basis
Table display uses UTC.

User Tags

User tags copied from the player record for triage and quick filtering.

Display Rule
The row shows the first tag and a count chip for additional tags; the tooltip lists all tags.
Caveat
Clicking the visible tag or a tooltip tag writes it into Search by tag and submits the filter form.

Action

Shows More Info only when the row has provider/raw details payload.

Caveat
More Info is read-only and does not retry or reclassify the failed deposit.
Filters6 topicsOpen details

Search player

Searches failed-deposit rows by player/transaction identity text.

Type
text
Match Behavior
Backend matches actionee email text, numeric transaction banking id, or numeric target/user id. It does not currently search full name on this shared banking endpoint.
Affects
table rows, CSV export

Currency

Narrows failed-deposit rows to a specific transaction currency.

Type
select
Match Behavior
Backend applies the currency filter only when the submitted value has at least three characters.
Affects
table rows, CSV export

Type

Narrows rows by transaction type while the page still stays failed-status focused.

Type
select
Options
All, Deposit, Withdraw, Add Money, Remove Money, Bonus, Bonus To Cash, Bonus To Forfeit, Bonus Expired, Bonus Zeroed Out
Match Behavior
Backend ignores the All/empty value and otherwise matches the transaction type exactly.
Affects
table rows, CSV export

Search by tag

Narrows failed-deposit rows by user tag text.

Type
text
Match Behavior
Case-insensitive contains match across the user's tag values.
Affects
table rows, CSV export

Date start

Start of the failed-deposit transaction creation-time window.

Type
date
Affects
table rows, CSV export

Date end

End of the failed-deposit transaction creation-time window.

Type
date
Affects
table rows, CSV export
More help

Related pages

Transactions / Banking

Filterable banking transaction dashboard with weekly summary cards, backend stats charts, CSV export, and a detailed ledger-style table.

Transactions / Casino

Game transaction dashboard with real-time list mode, monthly analytics mode, filterable table, and a dedicated transaction detail route.

Transactions / Casino Transaction Detail

Read-only detail page for a single casino transaction identified by `casinoTransactionId`.

Transactions / Failed Deposit Error Groups

Configuration surface for creating, editing, importing, exporting, and assigning failed-deposit error groups and their reasons.

Transactions / KYC

Action-heavy KYC document queue exposed under the transactions area for document review, verification, re-request, download, and third-party checks.

Transactions / Shared Detail Modals

Reusable read-only transaction payload modals for banking-style rows on banking, withdrawals, and failed-deposit surfaces.