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"
}]
}]
}
"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"
}]
}]
}
"chainId": 12345,
"loyaltyPrograms": [{
"code": "LP1_POINTS",
"pointExchangeRates": [{
"startDate": "2019-03-01",
"endDate": "2019-03-17",
"currencyCode": "USD",
"roundingRule": "roundup"
}]
}]
}