Manual Bonus Codes

Fluid Widget	Quick Deposit	Sweepstakes (Virtual)
Yes	No	No

When the Manual Bonus Codes feature is enabled in the CMS (Manual Bonus Codes Enabled), the widget displays a text input allowing the user to enter a bonus code manually. The widget validates the code using the verifyBonusCode Bridge API method.

Enabling the feature

The feature is controlled by the Manual Bonus Codes Enabled setting in the Fluid CMS. When enabled, a bonus code input field appears in the deposit flow alongside the regular bonus list.

Bridge handler

The host page must register a verifyBonusCode handler as described in the Window Bridge API documentation. The handler receives { code: string } (the trimmed user input) and must return a FluidBridgeVerifyBonusCodeResponse:

• When status is 'valid', the bonus object must conform to the same structure as entries in the Bonus Data Object - including optional paymentMethodFilter, logoUrl, and termsAndConditions.
• When status is 'invalid', the widget displays an error message to the user.
• Optionally, return autoOptedIn: true on a valid response to control the post-validation bonus UX. See autoOptedIn behaviour for the full behaviour table.

Pre-filling a code

The prefilled-bonus-code attribute pre-fills the manual bonus code input field. The code is not auto-validated; the user must click "Apply" to trigger verification via the Bridge API.