Skip to main content

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
test123-1sJ57hgit-838ab4b72d221a585af8b4bff7a540231
Marialukeskywalker-7sJ51hghg-838ab4b72d221a585af8b4be7a540232
LucasPrincessLeia-9sh57hgty-238ab4b72d88rj1a585af8b4be7a540235
BuzzLightyear-4sJ17hgih-638ab4b72d2jdfj585af8b4be7a540236
FaMulan621-3sJ47hgis-738ab4b72d221a585asdnb4be7a5402675
1969072078348482-9sJ57hyur-138ab4b72d2sdfa585af8b4be7a540786

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.