User Gating

DUPR features are provided to users based on a subscription model. Partners must adhere to these rules to ensure users have the appropriate access.

Fetching User Entitlements

To gatekeep specific features, you must fetch a user's entitlements using the User Access Token obtained during the SSO Login flow.

Environment	API
UAT	UAT: Fetch User Entitlements
Production	Prod: Fetch User Entitlements

Caching: You may cache a user's entitlements for up to 24 hours to avoid redundant API calls when a user performs multiple actions within a single day. After 24 hours, you must re-fetch the user's entitlements to ensure they reflect the most current subscription state.

Example Response Object:

{ 
   "status": "", // Deprecated
   "displayName": "DUPR LLC",
   "entitlements": {
      "tournaments": [
        "BASIC_L1", "VERIFIED_L1", "PREMIUM_L1"
      ],
      "merchandise": [
        "PREMIUM_L1"
      ]
   }
}

---

Understanding User Entitlements

Entitlements define what a user is eligible for within a specific resource.

Entitlement	Description
BASIC_L1	Mandatory Requirement: Indicates this user is eligible for the basic tier of a resource. Its absence indicates the user is restricted or banned.
PREMIUM_L1	Indicates eligibility for the premium tier (e.g. DUPR+ restricted tournaments).
VERIFIED_L1	Indicates the user is eligible for resources requiring identity verification.

---

Platform Requirements

To maintain a full integration status, your platform must support the following gating logic:

1. The Baseline Requirement

A user must have the BASIC_L1 entitlement to perform any actions on the platform. If this entitlement is missing from the response, the user should be treated as restricted or unauthorized for play.

1. Premium Event Support It is a requirement for partner platforms to provide the option for Premium Events. Logic: When creating or managing events, your system must check for the PREMIUM_L1 entitlement. Restriction: If designated as a Premium event (e.g., DUPR+ only), users without the PREMIUM_L1 tag must be prevented from registering or participating.

---

Understanding Resources

Resources are the categories of play or features that entitlements apply to. Each key in the entitlements map is a resource, and its value is the list of entitlements the user holds for that resource.

Resource	Description
tournaments	Organized, rated events. Covers leagues and tournaments, but not necessarily other events, such as open play.
merchandise	Discounts and offers on DUPR merchandise. A user carrying PREMIUM_L1 is eligible for member merchandise pricing; an empty list means standard pricing.

tournaments and merchandise are the resources currently in use. New resources may be added over time — treat any unrecognized resource key as informational and ignore it, rather than failing.

---

Testing Premium & Verified Users in UAT

To test PREMIUM_L1 and VERIFIED_L1 entitlements in UAT, you must complete the DUPR+ signup flow using a Stripe test card.

Steps

1. Complete the SSO Login flow in UAT. After linking their account, eligible users will see the following screen:

1. Click Try DUPR+ Free and complete the DUPR+ signup process.

2. When prompted for payment, use a Stripe test card to complete the transaction.

3. Once the signup is complete, the user's entitlements will include PREMIUM_L1 and VERIFIED_L1.