Estimate loyalty points

Estimates the number of points a customer will receive for a given order in the loyalty campaign under its earning rules.

This endpoint returns only an estimation, not a precise point value.

Also, this estimation works only for the Order paid earning rules. If a campaign includes tiers, mappings, and multiple earning rules, the calculation becomes more complex. During final calculation, a customer may change tiers and earn more or fewer points depending on other factors.

POST /v1/loyalties/{campaignId}/qualifications

Estimate loyalty points

cURL

curl --request POST \
  --url https://{cluster}.voucherify.io/v1/loyalties/{campaignId}/qualifications \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '
{
  "customer": {
    "source_id": "customerSourceID",
    "metadata": {
      "reason": "loyaltyQualifications"
    }
  },
  "order": {
    "source_id": "ord_113628fa0685537f99",
    "metadata": {
      "source": "qualifyPoints"
    }
  }
}
'

200

Point estimation response

{
  "campaign": {
    "id": "camp_6hAtKbSF3iMj8wN8HjlvPuQG",
    "name": "Loyalty-campaign",
    "object": "campaign"
  },
  "points_estimation": 51
}

Authorizations

X-App-Id & X-App-TokenX-Voucherify-OAuth

X-App-Id · string · header · required

X-App-Token · string · header · required

Path Parameters

campaignId · string · required

Unique campaign ID of the loyalty program.

Example:

"camp_rRsfatlwN7unSeUIJDCYedal"

Body

application/json

Provide customer source_id and order source_id.

Request body schema for estimating loyalty points for an order with POST /loyalties/{campaignId}/qualifications.

customer · Customer · object · required

Show child attributes

order · object · required

Details regarding the order being processed. You can provide either source_id of an existing order or an inline order/cart object (for example amount, items, or metadata). When both are provided, inline order data takes precedence.

Show child attributes

Response

200

application/json

Returns campaign details and estimated number of points.

Response body schema for estimating loyalty points for an order with POST /loyalties/{campaignId}/qualifications.

campaign · object · required

Details about the campaign associated with the estimation.

Show child attributes

points_estimation · integer · required

The calculated estimation of points based on the order data and loyalty campaign's earning rules.