Introduction

Wix Payments events are fired in you site's backend when certain events occur with payments created using the Pay API. 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 payment events.

Note that backend events don't work when previewing your site.

To add a payment 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:

export function <wixAppName>_<eventName>(event) { }

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

export function wixPay_onPaymentUpdate(event) { }