Skip to main content

Loyalty Point Exchange Rates

Hotel
Loyalty
REST API
Hospitality
Try Now

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"
        }]
    }]
}