Earning Rule Object

Earning Rule

All of:

EarningRuleBase

Attributes Description

Attributes	Description
validation_rule_id `string`, `null`	A unique validation rule identifier assigned by the Voucherify API. The validation rule is verified before points are added to the balance.
updated_at `string`, `null`	Timestamp representing the date and time when the earning rule was last updated in ISO 8601 format.
active `boolean`	A flag to toggle the earning rule on or off. You can disable an earning rule even though it's within the active period defined by the start_date and expiration_date of the campaign or the earning rule's own start_date and expiration_date. `true` indicates an active earning rule `false` indicates an inactive earning rule

validation_rule_id
string, null

A unique validation rule identifier assigned by the Voucherify API. The validation rule is verified before points are added to the balance.

updated_at
string, null

Timestamp representing the date and time when the earning rule was last updated in ISO 8601 format.

active
boolean

A flag to toggle the earning rule on or off. You can disable an earning rule even though it's within the active period defined by the start_date and expiration_date of the campaign or the earning rule's own start_date and expiration_date.

true indicates an active earning rule
false indicates an inactive earning rule

EarningRuleBase

Attributes Description

id
string

Assigned by the Voucherify API, identifies the earning rule object.

created_at
string

Timestamp representing the date and time when the earning rule was created in ISO 8601 format.

loyalty One of: Define fixed amount of points, Calculate points proportionally

event

Defines the event which triggers the earning rule to add points to a loyalty card.

Earning Rule Event

custom_event
object

Attributes	Description
schema_id `string`

segment
object

Contains the id of a customer segment. Required for the customer.segment.entered option in event.

Attributes	Description
id `string`	Contains a unique identifier of a customer segment. Assigned by the Voucherify API.

source
object

Contains the custom earning rule name and parent campaign.

Attributes	Description
banner `string`	Name of the earning rule. This is displayed as a header for the earning rule in the Dashboard.
object_id `string`	A unique campaign identifier assigned by the Voucherify API.
object_type `string`	Defines the object associated with the earning rule. Defaults to `campaign`. Available values: `campaign`

object
string

The type of object represented by JSON. Default is earning_rule.

Available values: earning_rule

automation_id
string

For internal use by Voucherify.

start_date
string

Start date defines when the earning rule starts to be active. Activation timestamp is presented in the ISO 8601 format. Earning rule is inactive before this date. If you don't define the start date for an earning rule, it'll inherit the campaign start date by default.

expiration_date
string

Expiration date defines when the earning rule expires. Expiration timestamp is presented in the ISO 8601 format. Earning rule is inactive after this date.If you don't define the expiration date for an earning rule, it'll inherit the campaign expiration date by default.

validity_timeframe
object

Set recurrent time periods when the earning rule is valid. For example, valid for 1 hour every other day.start_date required when including the validity_timeframe.

Attributes	Description
duration `string`	Defines the amount of time an earning rule will be active in ISO 8601 format. For example, an earning rule with a duration of PT1H will be valid for a duration of one hour.
interval `string`	Defines the intervening time between two time points in ISO 8601 format, expressed as a duration. For example, an earning rule with an interval of P2D will be valid every other day.

validity_day_of_week
array

Integer array corresponding to the particular days of the week in which the earning rule is valid.

0 Sunday
1 Monday
2 Tuesday
3 Wednesday
4 Thursday
5 Friday
6 Saturday

metadata
object

The metadata object stores all custom attributes assigned to the earning rule. A set of key/value pairs that you can attach to an earning rule object. It can be useful for storing additional information about the earning rule in a structured format.

Define fixed amount of points

Attributes	Description
type `string`	The number of points to be added to the loyalty card. Available values: `FIXED`
points `integer`	Defines how the points will be added to the loyalty card. FIXED adds a fixed number of points.

Calculate points proportionally

One of:

Order, Order Items, Customer Metadata, Earning Rule Proportional Custom Event

Earning Rule Event

Available values: order.paid, customer.segment.entered, custom_event, customer.loyalty.tier.upgraded, customer.loyalty.tier.downgraded, customer.loyalty.tier.prolonged, customer.loyalty.tier.joined, customer.loyalty.tier.left

Order

One of:

Order Amount, Order Total Amount, Order Metadata

Order Items

One of:

Order Items Quantity, Order Items Amount, Order Items Subtotal Amount

Customer Metadata

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

CUSTOMER_METADATA: Customer Metadata (X points for every Y in metadata attribute, defined in the property key under the customer.metadata object)

Available values: CUSTOMER_METADATA

customer
object

Attributes Description

metadata
object

Defines the ratio based on the property defined in the calculation_type parameter. For every given increment of value (1, 10, etc) defined in the every parameter for the property defined in calculation_type, give the customer the number of points defined in the points parameter. In other words, for every order metadata property value, give points.

Attributes	Description
every `integer`	For how many increments of the customer metadata property to grant points for.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.
property `string`	Customer metadata property.

Earning Rule Proportional Custom Event

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

CUSTOM_EVENT_METADATA: Custom event metadata (X points for every Y in metadata attribute).

Available values: CUSTOM_EVENT_METADATA

custom_event
object

Attributes Description

metadata
object

Attributes	Description
every `integer`	For how many increments of the customer metadata property to grant points for.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.
property `string`	Custom event metadata property.

Order Amount

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

ORDER_AMOUNT: Pre-discount order amount (X points for every Y spent excluding discounts)

Available values: ORDER_AMOUNT

order
object

Attributes Description

amount
object

Defines the ratio based on the property defined in the calculation_type parameter. For every set of value (1, 10, etc) defined in the every parameter for the property defined in calculation_type, give the customer the number of points defined in the points parameter. In other words, for every calculation_type, give points.

Attributes	Description
every `integer`	Value is multiplied by 100 to precisely represent 2 decimal places. For example, a $10 order amount is written as 1000.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.

Order Total Amount

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

ORDER_TOTAL_AMOUNT: Total order amount (X points for every Y spent including discount)

Available values: ORDER_TOTAL_AMOUNT

order
object

Attributes Description

total_amount
object

Attributes	Description
every `integer`	Value is multiplied by 100 to precisely represent 2 decimal places. For example, a $10 order amount is written as 1000.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.

Order Metadata

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

ORDER_METADATA: Order Metadata (X points for every Y in metadata attribute, defined in the property key under the order.metadata object)

Available values: ORDER_METADATA

order
object

Defines the formula for calculating points proportionally.

Attributes Description

metadata
object

Attributes	Description
every `integer`	For how many increments of the order metadata property to grant points for.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.
property `string`	Order metadata property.

Order Items Quantity

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

ORDER_ITEMS_QUANTITY: Quantity of items defined in order_items.quantity.object & .id (X points for every Y items excluding free items)

Available values: ORDER_ITEMS_QUANTITY

order_items
object

Attributes Description

quantity
object

Attributes	Description
every `integer`	Value is multiplied by 100 to precisely represent 2 decimal places. For example, a $10 order amount is written as 1000.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.
object `string`	Type of object taken under consideration. Available values: `products_collection`, `product`, `sku`
id `string`	Unique ID of the resource, i.e. pc_75U0dHlr7u75BJodrW1AE3t6, prod_0bae32322150fd0546, or sku_0b7d7dfb090be5c619.

Order Items Amount

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

ORDER_ITEMS_AMOUNT; Pre-discount amount spent on items defined in the order_items.amount.object & .id (X points for every Y spent on items excluding discounts)

Available values: ORDER_ITEMS_AMOUNT

order_items
object

Attributes Description

amount
object

Attributes	Description
every `integer`	Value is multiplied by 100 to precisely represent 2 decimal places. For example, a $10 order amount is written as 1000.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.
object `string`	Type of object taken under consideration. Available values: `products_collection`, `product`, `sku`
id `string`	Unique ID of the resource, i.e. pc_75U0dHlr7u75BJodrW1AE3t6, prod_0bae32322150fd0546, or sku_0b7d7dfb090be5c619.

Order Items Subtotal Amount

Attributes Description

type
string

Defines how the points will be added to the loyalty card.PROPORTIONAL adds points based on a pre-defined ratio.

Available values: PROPORTIONAL

calculation_type
string

ORDER_ITEMS_SUBTOTAL_AMOUNT; Amount spent on items defined in the order_items.subtotal_amount.object & .id (X points for every Y spent on items including discounts)

Available values: ORDER_ITEMS_SUBTOTAL_AMOUNT

order_items
object

Attributes Description

subtotal_amount
object

Attributes	Description
every `integer`	Value is multiplied by 100 to precisely represent 2 decimal places. For example, a $10 order amount is written as 1000.
points `integer`	Number of points to be awarded, i.e. how many points to be added to the loyalty card.
object `string`	Type of object taken under consideration. Available values: `products_collection`, `product`, `sku`
id `string`	Unique ID of the resource, i.e. pc_75U0dHlr7u75BJodrW1AE3t6, prod_0bae32322150fd0546, or sku_0b7d7dfb090be5c619.