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 |
|---|---|---|---|
| uuid | uuid | n/a | String |
| email_address | data[email_address] | {{email_address}} | String |
| external_email_id | data[external_email_id] | {{external_email_id}} | String |
| first_name | data[first_name] | {{first_name}} | String |
| last_name | data[last_name] | {{last_name}} | String |
| code | data[code] | {{code}} | String |
| expiration_date | data[expiration_date] | {{expiration_date}} | Date Format: YYYY-MM-DDTHH:MM:SS+0:00 |
| account_number | data[account_number] | {{account_number}} | String |
| balance | data[balance] | {{balance}} | String |
| tier | data[tier] | {{tier}} | String |
| offer_value | data[offer_value] | {{offer_value}} | String |
| loyalty_tier | data[loyalty_tier] | {{loyalty_tier}} | String |
| loyalty_balance | data[loyalty_balance] | {{loyalty_balance}} | Float |
| loyalty_unit_of_measure | data[loyalty_unit_of_measure] | {{loyalty_unit_of_measure}} | String |
See how first class fields can be in the `tokens’ fields with Wallet Campaign API, Wallet Messaging API, and Wallet Batch Updates.