Refund and reversal handling
When an invoice is refunded, the system can automatically reverse the loyalty points that were earned on that invoice. This article covers how refund reversals work for both regular and tiered programs, including the configurable reversal setting and allocation logic.
On this page
- Before you begin
- Points reversal on refunds
- Payment removal vs refund
- Regular program refund behavior
- Tiered program refund behavior
- Individual tier ratio types
- Related articles
Before you begin
- Point reversal on refunds is controlled by the Allow points reversal on refunds organization setting.
- Reversals are processed automatically -- no manual intervention is required when the setting is enabled.
Points reversal on refunds
When Allow points reversal on refunds is enabled:
- The system reverses earned loyalty points proportionally based on the refund payment versus the original payment amount.
- For example, if a guest earned 100 points on a $200 invoice and you refund $100, the system reverses 50 points.
When the setting is disabled:
- The system does not reverse points on refund. The guest retains all earned points.
Payment removal vs refund
The system distinguishes between two types of reversal:
- Refund -- A refund is issued for a closed invoice. Point reversal follows the configurable setting and calculates proportionally.
- Payment removal -- A payment is removed from an invoice (not a refund). The system reverses all accrued points for that invoice, regardless of the refund setting. This full reversal occurs because the original payment is being undone entirely.
Regular program refund behavior
In regular programs, refunds insert into the accrual processing queue for batch processing. The system reverses points proportionally based on the refund amount.
Tiered program refund behavior
In tiered programs, refunds create negative point records in the ledger. The system then processes these through a priority-based allocation that matches negative entries against positive entries in the following order:
- Same invoice
- Parent invoice
- Same program
- Same earning action
- Refund action type
- Has expiry date
- Created within validity period
This priority order ensures that reversed points are matched against the most relevant original earning entries first.
Individual tier ratio types
When a guest has been in multiple tiers during an earning period, the system uses the Individual tier ratio type setting to determine how points are reversed:
- Only for tier jumps (2+ tiers) -- The ratio is applied only when the tier change involved a jump of two or more tiers (not the immediate next tier).
- For any tier upgrade -- The ratio is applied for every tier upgrade, regardless of the number of tiers jumped.