Widget methods

Open widget

You can manually trigger the opening of the Joy floating widget with this method:

joyInstance.openWidget()

Close widget

You can manually trigger the close of the Joy floating widget with this method:

joyInstance.closeWidget()

Reload customer data

If you issue or redeem points using the API or Joy SDK and want other widgets or the loyalty page to refresh the customer’s balance and tier in real time, you can trigger a reload by calling:

window.joyInstance.updateCustomerState()

Open page

You can use this method to open a targeted page on the floating widget.

joyInstance.openPage(page)
//View below for possible values

All possible values for the page would be:

Page value	Page description
home	The home page the widget
howToEarn	The earning program list of the widget
howToRedeem	The redeeming program list of the widget
milestoneV2	The milestone rewards page of the widget
activities	The point history page of the widget
rewards	The coupon list page of the widget

Open to a redeeming program

You can get the list of the redeeming programs available and then use the program ID to open:

joyInstance.openRedeemProgram(programId)