Skip to main content
Version: v2

UserId for web Iframe

The Reward Center is an iframe embedded on your site containing a list of incentivized surveys and offers. It’s one of our simplest products to integrate and requires zero maintenance.

Engage your audience with these earning opportunities and get paid every time your user completes one.

Understanding the RapidoReach User ID​

Every user needs an ID to enter a survey.

The UID is made up of three parts:

  1. The Internal User ID
  2. Application ID (App ID)
  3. The Checksum.

This 3 part ID isn’t required for the Project API or the Invite API.

Do not use '-' (dash or dashed) in your Internal User ID
Example UIDs
User123-1sJ57hgit-e9c58bb1623c49fb3e1aff5bc633bd85
player_456-1sJ57hgit-0123456789abcdef0123456789abcdef
1969072078348482-1sJ57hgit-fedcba9876543210fedcba9876543210

The second and third rows demonstrate the required format only. Generate the real checksum with your own App Key before using a UID in production.

Internal User ID​

The Internal User ID is a case-sensitive alphanumeric string of up to 240 (we recommend keeping them short) characters in length. It should correspond to the user’s ID in your database. (Avoid using dash(-) in your internal user id with rapidoreach)

Application ID​

The Application ID (App ID) is your application’s identifier and can be alphanumeric. Each application you create has a unique App ID. You can find your App ID below the application name in the application list.

Checksum​

Generating a checksum is important to keep every transaction secure and protect the integrity of every generated user ID. The checksum is the third section of the UID and must be the full 32-character lowercase hex MD5 of this exact string (with hyphens):

"<InternalUserId>-<AppId>-<AppKey>"

Use your App Key for the checksum. Do NOT use the App Secret (a.k.a. Transaction Key) for UID generation.

App Secret (Transaction Key)​

The App Secret (sometimes referred to as Transaction Key) is used for S2S callbacks and link signing (HMAC), not for UID generation. You can find the App Secret in the application credentials section.

User Profiles​

Depending on the product, you may also register a profile for each of your users.