Customer loyalty
Loyalty scheme providers can use the Mews Connector API to synchronize their loyalty programs with Mews Operations. Hotel staff can then easily access a guest's membership status, including loyalty tier such as "Gold member", through the guest profile within the Mews system.
Loyalty data modelThe data model for Loyalty consists of three main entities:
Loyalty Program This is the main loyalty scheme or program. A guest can be a member of multiple programs.
Loyalty Tier You can optionally define tiers or levels of membership for your program.
Loyalty Membership A Loyalty Membership describes the relationship between a customer or guest and a loyalty program. This includes reward points, loyalty tier and membership expiration date.
Chains
Loyalty programs are set up in Mews at the above-property chain level. However, this does not prevent individual properties (called Enterprises in Mews) from having loyalty programs, because a property by default is in a chain of one.
Where can I obtain the Chain identifier?You can obtain the Chain identifier for an enterprise or property using Get configuration.
Set up loyalty programs
Use Add loyalty programs to create your loyalty programs in Mews. If using a normal, single enterprise Access Token, the programs will be created for the chain corresponding to the enterprise within scope of the Access Token. If using a multi-property Portfolio Access Token, you must specify the ChainId. The programs will then be created for the specified chain.
To create a program, you must specify a program name, program code (used to match the loyalty on bookings such as those coming in to Mews from the Mews Channel Manager API), type of program, and subscription model (Free or Paid). To see what loyalty programs are already set up, use Get all loyalty programs, which can be called with various filter parameters, depending on your requirements.
'How to' use case | API Operations |
How to add a Loyalty Program | |
How to get a list of Loyalty Programs | |
How to get the Chain identifier for a property |
How can I validate the Loyalty Programs setup?With access to Mews Operations, you can go to the Loyalty section of the Customer Profile and manually add a customer to a program. The available programs should reflect what you have configured through the API. For more information, see these articles in the Mews Help Center:
Maintain your loyalty programs
To make changes to existing loyalty programs, use Update loyalty programs. To delete unwanted loyalty programs, use Delete loyalty programs.
'How to' use case | API Operations |
How to update a Loyalty Program | |
How to delete a Loyalty Program |
Set up loyalty tiers
If any of the loyalty programs use tiers, set up those tiers and link them to the programs, using Add loyalty tiers. To see what loyalty tiers are already set up, use Get all loyalty tiers, which can be called with various filter parameters, depending on your requirements. To make changes to existing loyalty tiers, use Update loyalty tiers. To delete unwanted loyalty tiers, use Delete loyalty tiers.
'How to' use case | API Operations |
How to add a Loyalty Tier | |
How to get a list of Loyalty Tiers | |
How to update a Loyalty Tier | |
How to delete a Loyalty Tier |
Add guests to loyalty programs
Loyalty Memberships are used to connect guests (called Customers in Mews) with loyalty programs. To connect a guest or customer to a loyalty program, use Add loyalty memberships. Specify the identifier of the loyalty program, the identifier of the customer account, and optionally you can specify their reward points, a membership expiration date, a URL to an entry in your loyalty system, a loyalty tier that the customer belongs to, and/or the state of their membership, e.g. Pending. If the customer is a member of more than one loyalty program within scope of the chain, specify which one is the primary program against which points should be allocated, using the isPrimary JSON property. To fetch a list of guest memberships, use Get all loyalty memberships, which can be called with various filter parameters.
'How to' use case | API Operations |
How to add a Loyalty Membership | |
How to get a list of Loyalty Memberships |
Maintain your guest memberships
To make changes to guest loyalty memberships, use Update loyalty memberships. To remove guest loyalty memberships, use Delete loyalty memberships.
'How to' use case | API Operations |
How to update a Loyalty Membership | |
How to delete a Loyalty Membership |
Testing your integration
Ensure you follow our general guidelines for testing integrations. For additional help when working with the demo environment, there is a range of helpful articles in the Mews Help Center. These are available in a number of languages. The following articles may be of interest:
Last updated