Skip Navigation

Loyalty Point Exchange Rates

Hotel
Loyalty
REST API
Hospitality

What is it?

Loyalty Point Exchange API creates or updates the conversion rate between points used in a loyalty program and an ISO currency code. This allows a guest to redeem points for a free or discounted hotel night.

Why use it?

This API allows a chain to upload a bulk mapping between currencies and loyalty points. This is an Administration function that is used to set rate that the chain is willing to accept for exchanging 1 point to 1 unit of a given currency for a provided date range.

How to use

Update Mulitple Loyalty Point to Currency Exchange Rates

{
    "chainId": 12345,
    "loyaltyPrograms": [{
        "code": "LP1_POINTS",
        "pointExchangeRates": [{
            "amount": 0.1,
            "startDate": "2019-01-01",
            "currencyCode": "USD",
            "roundingRule": "roundup"
        }, {
            "amount": 0.2,
            "startDate": "2019-03-10",
            "endDate": "2019-03-17",
            "currencyCode": "USD",
            "roundingRule": "roundup"
        }, {
            "amount": 0.135,
            "startDate": "2019-01-01",
            "currencyCode": "CAD",
            "roundingRule": "roundup"
        }]
    }]
}

Delete a Loyalty Point Exchange Rate

An exchange rate can be deleted by removing the @amount parameter from the request.

{
    "chainId": 12345,
    "loyaltyPrograms": [{
        "code": "LP1_POINTS",
        "pointExchangeRates": [{
            "startDate": "2019-03-01",
            "endDate": "2019-03-17",
            "currencyCode": "USD",
            "roundingRule": "roundup"
        }]
    }]
}