Skip to main content

Business Loyalty Plans Model

A business loyalty plan records how one business participates in a loyalty plan. It can override the plan's accumulation, redemption, maximum, and expiration settings for that business.

ActionMethodResource
List business settingsGET/loyalty_plans/{loyalty_plan_id}/businesses
Find business settingsGET/loyalty_plans/{loyalty_plan_id}/businesses/{business_id}

Both list and find operations require administrator authentication. See List business loyalty plans and Find a business loyalty plan.

Older documentation also describes create, update, and delete operations under singular /business paths. Those paths do not match the plural routes listed here, and the public API reference does not list corresponding operations.

Representative fields​

Identity fields include id, business_id, and loyalty_plan_id. Behavior is controlled by redeems, accumulates, redemption_rate, accumulation_rate, maximum_redemption_type, maximum_redemption_rate, maximum_accumulation, and expire_after_minutes.

Values 1 and 2 are listed for maximum_redemption_type, but their meanings are not clear. Use the operation-specific contract and product configuration to determine accepted values, requirements, and responses.

Schema properties​

Schema: BusinessLoyaltyPlan

NameTypeDescription
accumulatesboolean | null—
accumulation_ratenumber | null—
business_idnumber | null—
expire_after_minutesany—
idinteger | null—
loyalty_plan_idnumber | null—
maximum_accumulationnumber | null—
maximum_redemption_ratenumber | null—
maximum_redemption_typeany—
redeemsboolean | null—
redemption_ratenumber | null—