Guides
Start typing to search…

First Class Fields

First-class fields are fields that contain user-specific data, such as account_number or first_name. The fields can be passed onto a wallet item either during install, using the tokens in the SmartLink URL or via an API call.

You can use these fields to personalize the content of your wallet item or as filter criteria when building reports.

Below is a list of the first-class fields you can use with our Wallet Manager APIs. All SmartLink personalization parameters as a URL query parameter will be accepted and stored. Note that the fields cannot be used as either a key identifier or as a filter for a Wallet Batch Update.

Field Name

SmartLink URL Personalization Format

Campaign UI Configuration Format

Type

email_address

data[email_address][email_address]

{{email_address}}

String

external_email_id

data[external_email_id][external_email_id]

{{external_email_id}}

String

first_name

data[first_name][first_name]

{{first_name}}

String

last_name

data[last_name][last_name]

{{last_name}}

String

code

data[code]

{{code}}

String

expiration_date

data[expiration_date][expiration_date]

{{expiration_date}}

Date
Format: YYYY-MM-DDTHH:MM:SS+0:00

account_number

data[account_number][account_number]

{{account_number}}

String

balance

data[balance]

{{balance}}

String

tier

data[tier]

{{tier}}

String

offer_value

data[offer_value][offer_value]

{{offer_value}}

String

loyalty_tier

data[loyalty_tier][loyalty_tier]

{{loyalty_tier}}

String

loyalty_balance

data[loyalty_balance][loyalty_balance]

{{loyalty_balance}}

Float

strip_image_code

data[strip_image_code][strip_image_code]

{{strip_image_code}}

String

See how first class fields can be in the `tokens’ fields with Wallet Campaign API, Wallet Messaging API, and Wallet Batch Updates.