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 NameSmartLink URL Personalization FormatCampaign UI Configuration FormatType
email_addressdata[email_address]{{email_address}}String
external_email_iddata[external_email_id]{{external_email_id}}String
first_namedata[first_name]{{first_name}}String
last_namedata[last_name]{{last_name}}String
codedata[code]{{code}}String
expiration_datedata[expiration_date]{{expiration_date}}Date
Format: YYYY-MM-DDTHH:MM:SS+0:00
account_numberdata[account_number]{{account_number}}String
balancedata[balance]{{balance}}String
tierdata[tier]{{tier}}String
offer_valuedata[offer_value]{{offer_value}}String
loyalty_tierdata[loyalty_tier]{{loyalty_tier}}String
loyalty_balancedata[loyalty_balance]{{loyalty_balance}}Float
strip_image_codedata[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.