Pending Loyalty Points Definition
Pending loyalty points are points that a customer has earned through a transaction or action but are not yet available for redemption. These points are typically held in a "pending" or "processing" state for a specific period, often to allow for:
- Return windows (e.g., in retail, to avoid fraud from returned items).
- Fraud prevention checks.
- Service completion (e.g., travel must be completed before points are confirmed).
Once the waiting period ends and conditions are met, pending points become active or available, meaning they can be used for redemptions, discounts, or rewards.
In Voucherify, pending loyalty points are points earned by customers that are temporarily held before becoming available for redemption. This mechanism helps prevent fraud, manage returns, and ensure that rewards are granted only after specific conditions are met.
How pending points work in Voucherify?
- Configuration during the earning rule setup – when creating an earning rule, you can specify a pending period in days. This defines how long the points remain in a pending state before activation.
- Automatic activation – after the pending period elapses, points are automatically activated and added to the customer's loyalty card. This transition is marked by the
PENDING_POINTS.ACTIVATEDevent. Alternatively, pending points can be manually activated using theActivate Member Pending PointsAPI endpoint. This provides flexibility for scenarios requiring manual review or additional processing. - Adjustment and cancellation – pending points can be adjusted (increased or decreased) or canceled entirely using API endpoints.
- Monitoring pending points – you can retrieve a list of all pending points for a specific loyalty card using the
List Member Pending PointsAPI endpoint. Once points are activated, they no longer appear in this list.
This pending points system allows businesses to implement a delay between the earning of points and their availability for redemption, aligning reward issuance with business processes such as order fulfillment, return periods, or fraud checks.
