ticket-perforatedFree to Play

Reward based matchups

GYP matchups support the ability to "payout" users with client specific Rewards when a matchup settles. When enabled, these matchups do not require money in order to create or accept.

These types of matchups are called "Free to Play", FTP for short. It allows tenants to provide a list of available Rewards for the active user to consume by participating in a GYP related matchup.

circle-info

Reward-based, Free to Play matchups are only enabled for the Lucra Games You Play and Sports You Watch products.

Technical Brief

LucraReward

LucraRewards are data models that contain information around the available reward the user can expect to attach to matchups and eventually claim once the matchup is completed.

The LucraReward data model will contain the following properties

  • RewardID - Tenant specific identifier

  • Title - Shown on selection and reward pill components

  • Descriptor - Details description of the reward's benefits

  • IconURL - Smaller icon to show alongside the reward pill components

  • BannerIconURL - Larger icon to show when viewing the reward options

  • Disclaimer - Any details to provide the user with when selecting the reward

  • Metadata - Nested details that can be passed into the reward payload to further identify the reward for the tenant

Lucra expects the client to provide the following:

  1. A list of LucraRewards at runtime from the frontend tenant

    1. These will be used for Creation purposes only

    2. (#1 in flow above)

  2. A backend webhook to notify the Tenant's backend that a user has participated (won/lost/tied) with a given LucraReward attached

    1. This allows the tenant backend to confirm a user's ability to claim a given reward when the user eventually navigates to claim said Reward

    2. (#3 in flow above)

  3. The ability to claim a LucraReward once the matchup is in a completed state within the frontend tenant

    1. This is a simple callback to navigate the user to view the details of the LucraReward passed in with the creation

    2. (#2 in flow above)

Last updated