Manual Bonus Codes

The Manual Bonus Codes feature enables users to enter bonus codes directly through a text input field during deposits. This capability is controlled by the Manual Bonus Codes Enabled setting in the Back Office. When enabled, the bonus code input appears in the deposit flow alongside the regular bonus list.

Availability

Works with the Fluid Cashier only — not for Quick Deposit or Fluid Sweepstakes.

Bridge API handler

The host page must register a verifyBonusCode handler through the Window Bridge API. The handler receives { code } — the user’s input, trimmed — and returns the verification result:

window.fluid.bridge.handleRequest('verifyBonusCode', async ({ code }) => {
    const result = await myApi.verifyBonusCode(code);

    if (!result.valid) {
        return { status: 'invalid' };
    }

    return {
        status: 'valid',
        bonus: {
            code: result.code,
            title: result.title,
            description: result.description,
            logoUrl: result.logoUrl,
            termsAndConditions: result.termsAndConditions,
            minDeposit: result.minDeposit,
            maxBonus: result.maxBonus,
            maxBonusPercentage: result.maxBonusPercentage,
            paymentMethodFilter: result.paymentMethodFilter,
        },
        autoOptedIn: result.autoOptedIn,
    };
});

Response behaviour

The widget handles three scenarios:

Scenario	Result
Valid code	Bonus is displayed; the user confirms it to apply it
Valid code with `autoOptedIn: true`	Bonus is displayed and applied straight away, without the user having to select it
Invalid code	Error message shown to user

When status is 'valid', the bonus object follows the same structure as the entries in Bonus Data, including the optional paymentMethodFilter, logoUrl and termsAndConditions. See the Bridge API reference for the full autoOptedIn behaviour.

Pre-filling bonus codes

The prefilled-bonus-code attribute populates the input field automatically:

<fluid-widget prefilled-bonus-code="WELCOME100" ...></fluid-widget>