Introduction

Wix Loyalty events are fired in your site's backend when certain events related to loyalty occur in your site's backend. You can write event handlers that react to these events. Event handler functions receive data that corresponds to the event that has occurred. Use event handlers to create custom responses to loyalty events.

Note: Backend events don't work when previewing your site.

To add a loyalty event handler, add an events.js file to the Backend section of your site if one does not already exist. All event handler functions for your site are defined in this file.

Event handler functions are defined using the following pattern:

Copy

For example, an event handler that handles loyalty account updates looks like this:

Copy
Did this help?

onLoyaltyImportCreated( )


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Method Declaration
Copy
function wixLoyaltyImportsV1_onLoyaltyImportCreated(
  event: LoyaltyImportCreated,
): void;
Method Parameters
eventLoyaltyImportCreated
onLoyaltyImportCreated example
JavaScript
export function wixLoyaltyImportsV1_onLoyaltyImportCreated(event) { const eventId = event.metadata.id; const entityId = event.entity._id; }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?

onAccountPointsUpdated( )


An event that triggers when the points of a loyalty account are adjusted, earned, or redeemed.

The onAccountPointsUpdated() event handler runs when the points of a loyalty account are adjusted, earned, or redeemed. The received AccountPointsUpdated object contains information about the loyalty account that was updated.

Note: Backend events don't work when previewing your site.

Method Declaration
Copy
Method Parameters
eventAccountPointsUpdated
An event that triggered when a the points of a loyalty account is updated
JavaScript
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?

onAccountUpdated( )


An event that triggers when a loyalty account is updated.

The onAccountUpdated() event handler runs when a loyalty account is updated. The received AccountUpdated object contains information about the loyalty account that was updated.

The event also runs every 15 minutes when loyalty points are recalculated.

Note: Backend events don't work when previewing your site.

Method Declaration
Copy
Method Parameters
eventAccountUpdated
An event that triggers when a loyalty account is updated
JavaScript
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?

onCouponCreated( )


Triggered when a loyalty coupon is created.

Method Declaration
Copy
Method Parameters
eventCouponCreated
onCouponCreated example
JavaScript
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?