<- Object

Object

All versions ->

LoyaltyProgramAccrualRule

Defines an accrual rule, which is how buyers can earn points.

Link to section

Properties

Link to section

accrual_type

string

Required

Read only The type of the accrual rule that defines how buyers can earn points.

Link to section

points

integer(32-bit)

Read only The number of points that buyers earn based on the accrual_type.

Link to section

visit_minimum_amount_money

Read only When the accrual rule is visit-based (accrual_type is VISIT), this field indicates the minimum purchase required during the visit to quality for the reward.

Link to section

spend_amount_money

Read only When the accrual rule is spend-based (accrual_type is SPEND), this field indicates the amount that a buyer must spend to earn the points. For example, suppose the accrual rule is "earn 1 point for every $10 you spend". Then, buyer earns a point for every $10 they spend. If buyer spends $105, the buyer earns 10 points.

Link to section

catalog_object_id

string

Read only When the accrual rule is item-based or category-based, this field specifies the ID of the catalog object that buyers can purchase to earn points. If accrual_type is ITEM_VARIATION, the object is an item variation. If accrual_type is CATEGORY, the object is a category.

Link to section

excluded_category_ids

string [ ]

Read only When the accrual rule is spend-based (accrual_type is SPEND), this field lists the IDs of any CATEGORY catalog objects that are excluded from points accrual.

You can use the BatchRetrieveCatalogObjects endpoint to retrieve information about the excluded categories.

Link to section

excluded_item_variation_ids

string [ ]

Read only When the accrual rule is spend-based (accrual_type is SPEND), this field lists the IDs of any ITEM_VARIATION catalog objects that are excluded from points accrual.

You can use the BatchRetrieveCatalogObjects endpoint to retrieve information about the excluded item variations.