Implementation Checklist

Use this checklist to prepare, integrate, and validate your Fortune Wheel before launch.

Overview

Use this checklist to prepare your Fortune Wheel for launch.

It covers three areas:

  • Configuration in the Admin Panel

  • Backend integration flow

  • Frontend handling and final validation

Use it together with Creating Fortune Wheels, Managing Fortune Wheels, and How Probability Works.

circle-exclamation

1

Configure the wheel

Create the Fortune Wheel in the Admin Panel.

Make sure you:

  • Add all winning and non-winning fields

  • Assign correct probability values

  • Define visibility, availability, and targeting

  • Set redemption and budget limits

If you need help with setup, follow Creating Fortune Wheels.

2

Render the result in your app

Use GET /api/{storeCode}/reward/{id} to load the wheel definition.

Map the returned labels and rules to your visual slices.

3

Create the spin entry

Call POST /api/{storeCode}/reward/{reward}/buy.

This creates a unique redemption entry for a single spin.

Store the returned issuedRewardId. You need it for the draw request and result lookup.

4

Trigger the draw

Call POST /api/{storeCode}/redemption/{issuedRewardId}/draw.

This endpoint performs the random draw based on the configured wheel rules.

Each issuedRewardId can be drawn only once.

5

Confirm the prize outcome

Use GET /redemption/{issuedRewardId} to load the final redemption details.

After the draw:

  • Stop the animation on the returned result

  • Show a winning state when effects are present

  • Show a "Better luck next time" state when no effect is returned

If the reward grants units, you can also refresh the member wallet view to show the updated balance.


Sequence Diagram

Configuration Phase:

Spin Phase:


Go-live checklist

1. Admin Panel setup

2. Backend integration

3. Frontend experience

4. Final validation


Key endpoints

circle-info

The safest flow is always: buy → draw → fetch result.

Last updated

Was this helpful?