v1

latestOpenAPI 3.0.32026-07-243003151.2 MB
Accounts

Calculate Points to be Earned

This API method allows the calling application to request an amount of points calculation (how much points should be credited for that potential transaction). EES AIR will use Scheme Earn definitions, take into account what is the Total Transaction Value, where this transaction would happen (which Client Location) or which Rate should be used for that calculation and return proposed points amount.

get/scheme/{schemeId}/earn/calculate

Path parameters

schemeIdstring string required

EES AIR Scheme ID

Query parameters

totalTransactionValueinteger required

The monetary value of the transaction to base the earn calculation on, denominated to the smallest currency unit

location[storeId]string string

The incoming identifier of the store. If provided, it will be used by EES AIR to find a specific earn rate for a specific location. If not provided, the caller unit (arisen from used API key) will be used to find earn rate information. In both cases, we will also try and traverse the hierarchy to find a matching earn rate.

location[storeParentId]string string

The incoming identifier of the parent store. If passed, it will be used by EES AIR to find a specific earn rate for a specific location. Please note this parameter would be ignored if no location[storeId] provided

rateNamestring string

If passed, it will instruct EES AIR to use the specific override rate (not a default one)

Response

OK

totalTransactionValueinteger required

The value of the transaction used for the calculation

rateNamestring string required

The name of the used rate definition