Skip to main content

Withdrawal Warning

Fluid WidgetQuick DepositSweepstakes (Virtual)
YesNoNo

The withdrawal-warning attribute lets you surface a custom notice on the withdrawal input screen, for example, when an active bonus must be reviewed or cancelled before the player can withdraw. The warning appears in the initial (pre-focus) state of the amount input and is dismissed once the player focuses the input.

The attribute is observed while the wallet is closed: updating it then replaces the rendered warning the next time the wallet is opened.

The attribute value is a JSON string with the following shape:

type WithdrawalWarning = {
title: string; // required, shown as the heading
message?: string; // optional body text
ctaLabel?: string; // optional; when set, renders a CTA button. Clicking emits `withdrawal-warning-cta-clicked` (fluid-command)
};

Field rules:

  • title is required. If it is missing, the warning is silently not shown.
  • message and ctaLabel are optional and independent. ctaLabel works with or without a message.
  • When ctaLabel is set, a primary CTA button is rendered under the message. Clicking it emits a fluid-command event with message: "withdrawal-warning-cta-clicked". Use this to react on the host page (for example, navigate the player to the bonuses screen).
  • If the attribute value is not valid JSON, the widget emits an invalid-withdrawal-warning fluid-error event and renders no warning.

Minimal example, title and message only:

<fluid-widget
withdrawal-warning='{"title":"Active or Pending Bonuses","message":"You currently have an active/pending bonus. Please visit your profile and cancel the bonus to enable withdrawals."}'
...
>
</fluid-widget>

With an action CTA:

<fluid-widget
withdrawal-warning='{"title":"Active or Pending Bonuses","message":"You currently have an active/pending bonus. Please visit your profile and cancel the bonus to enable withdrawals.","ctaLabel":"Review bonuses"}'
...
>
</fluid-widget>

The related events are listed in the Events and errors catalogue.