v1

latestOpenAPI 3.0.1MIT2026-07-263151,3912.3 MB
Loyalties

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 also returns point estimation for created transactions (orders with status PAID)

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

Request body

Example request

{
  "order": {
    "customer_id": "cust_7iUa6ICKyU6gH40dBU25kQU1",
    "referrer_id": "cust_nM4jqPiaXUvQdVSA6vTRUnix"
  }
}

Response

Returns campaign details and estimated number of points.

points_estimationinteger required

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