| id |
Integer |
The ID of loyalty program. Internal ID of this entity. |
|
| created |
OffsetDateTime |
The time this entity was created. |
|
| title |
String |
The display title for the Loyalty Program. |
|
| description |
String |
Description of our Loyalty Program. |
|
| subscribedApplications |
List<Integer> |
A list containing the IDs of all applications that are subscribed to this Loyalty Program. |
|
| defaultValidity |
String |
The default duration after which new loyalty points should expire. Can be 'unlimited' or a specific time. The time format is a number followed by one letter indicating the time unit, like '30s', '40m', '1h', '5D', '7W', or 10M'. These rounding suffixes are also supported: - '_D' for rounding down. Can be used as a suffix after 'D', and signifies the start of the day. - '_U' for rounding up. Can be used as a suffix after 'D', 'W', and 'M', and signifies the end of the day, week, and month. |
|
| defaultPending |
String |
The default duration of the pending time after which points should be valid. Can be 'immediate' or a specific time. The time format is a number followed by one letter indicating the time unit, like '30s', '40m', '1h', '5D', '7W', or 10M'. These rounding suffixes are also supported: - '_D' for rounding down. Can be used as a suffix after 'D', and signifies the start of the day. - '_U' for rounding up. Can be used as a suffix after 'D', 'W', and 'M', and signifies the end of the day, week, and month. |
|
| allowSubledger |
Boolean |
Indicates if this program supports subledgers inside the program. |
|
| usersPerCardLimit |
Integer |
The max amount of user profiles with whom a card can be shared. This can be set to 0 for no limit. This property is only used when `cardBased` is `true`. |
[optional] |
| sandbox |
Boolean |
Indicates if this program is a live or sandbox program. Programs of a given type can only be connected to Applications of the same type. |
|
| tiersExpirationPolicy |
TiersExpirationPolicyEnum |
The policy that defines which date is used to calculate the expiration date of a customer's current tier. - `tier_start_date`: The tier expiration date is calculated based on when the customer joined the current tier. - `program_join_date`: The tier expiration date is calculated based on when the customer joined the loyalty program. |
[optional] |
| tiersExpireIn |
String |
The amount of time after which the tier expires. The time format is an integer followed by one letter indicating the time unit. Examples: `30s`, `40m`, `1h`, `5D`, `7W`, `10M`, `15Y`. Available units: - `s`: seconds - `m`: minutes - `h`: hours - `D`: days - `W`: weeks - `M`: months - `Y`: years You can round certain units up or down: - `_D` for rounding down days only. Signifies the start of the day. - `_U` for rounding up days, weeks, months and years. Signifies the end of the day, week, month or year. |
[optional] |
| tiersDowngradePolicy |
TiersDowngradePolicyEnum |
Customers's tier downgrade policy. - `one_down`: Once the tier expires and if the user doesn't have enough points to stay in the tier, the user is downgraded one tier down. - `balance_based`: Once the tier expires, the user's tier is evaluated based on the amount of active points the user has at this instant. |
[optional] |
| programJoinPolicy |
ProgramJoinPolicyEnum |
The policy that defines when the customer joins the loyalty program. - `not_join`: The customer does not join the loyalty program but can still earn and spend loyalty points. Note: The customer does not have a program join date. - `points_activated`: The customer joins the loyalty program only when their earned loyalty points become active for the first time. - `points_earned`: The customer joins the loyalty program when they earn loyalty points for the first time. |
[optional] |
| accountID |
Integer |
The ID of the Talon.One account that owns this program. |
|
| name |
String |
The internal name for the Loyalty Program. This is an immutable value. |
|
| tiers |
List<LoyaltyTier> |
The tiers in this loyalty program. |
[optional] |
| timezone |
String |
A string containing an IANA timezone descriptor. |
|
| cardBased |
Boolean |
Defines the type of loyalty program: - `true`: the program is a card-based. - `false`: the program is profile-based. |
|
| canUpdateTiers |
Boolean |
`True` if the tier definitions can be updated. |
[optional] |
| canUpdateJoinPolicy |
Boolean |
Indicates whether the program join policy can be updated. The join policy can be updated when this value is set to `true`. |
[optional] |
| canUpgradeToAdvancedTiers |
Boolean |
`True` if the program can be upgraded to use the `tiersExpireIn` and `tiersDowngradePolicy` properties. |
[optional] |