This API allows for manual adjustment of a customer's loyalty tier (slab), including upgrading, downgrading, renewing the current tier, or extending its expiry date.
Type of slab change being performed. Supported values: UPGRADE: Upgrade the customer's tier to a higher tier. DOWNGRADE: Downgrade a customer's tier to a lower tier. RENEWAL: Renew this customer's current tier. EXTEND_CURRENT_TIER_EXPIRY_DATE: Extend the customer's current tier expiry date.
toSlabName
String
Name of the slab to upgrade or downgrade the customer to. This parameter is required if slabAction = UPGRADE or DOWNGRADE. For example, to downgrade a customer from "Gold" to "Silver", provide the value as "Silver".
manualSlabActionValidity*
Enum
Validity period for the tier change. Supported values: FIXED_DURATION: Extends the slab expiry by a fixed number of days. SPECIFIC_DATE: Sets the slab expiry to a specific date in ISO YYYY-MM-DD HH:MM:SS format. CURRENT_TIER_EXPIRY_DATE: Maintains the current slab's expiry date in ISO YYYY-MM-DD HH:MM:SS format. AS_PER_TIER_STRATEGY: Calculates the expiry date based on the expiration strategy defined by the loyalty program.
manualSlabActionValidityUpto*
Long
Date or number of days the customer's tier upgrade or downgrade is valid till. If manualSlabActionValidity = FIXED_DURATION: Provide a numerical value. For example to extend the expiry by 15 days, provide this value as 15. If manualSlabActionValidity = SPECIFIC_DATE: Provide the date till when the tier is valid in YYYY-MM-DD format. For example to extend the expiry till 20th April, 2025, provide this value as 2025-04-20.
reassessTierOnNextActivity
Boolean
Specify if the customer's tier during their next transaction or activity should be re-evaluated. The value is false by default. true: The system will reassess the customer's tier during their next activity. false: No automatic reassessment will occur during the next activity and the tier upgrade will expire based on the expiry strategy defined.
slabChangeReason
String
Reason for changing, renewing or extending the customer's tier. Character limit: 255 characters.