How it works
When a member chooses to redeem points through the Plum catalogue, Loyalife:- Validates the member’s point balance and confirms it meets the minimum redemption threshold.
- Creates a secure SSO session and transfers the member to Plum’s catalogue in a single click — no separate Plum login required.
- Plum uses a separate Redemption Rate Token to apply the correct points-to-currency conversion rate configured in your program.
Authentication architecture
Loyalife uses two distinct API tokens for the Plum integration:
These tokens are stored separately in environment configuration. Previously, a single shared token was used for both operations, which caused session conflicts and inconsistent authentication. The separation ensures each operation has its own security context.
Both tokens are configured by the Loyalife implementation team. Program admins do not manage tokens directly — contact your Loyalife account team if a token needs to be rotated.
Redemption rate
The redemption rate defines how many loyalty points equal one unit of currency when redeeming through Plum. Example: If the redemption rate is set to 100 points = ₹1, a member with 5,000 points has ₹50 in redemption value on Plum. The redemption rate is configured in Configuration → Marketplace Settings. Changes to the rate use the Redemption Rate Token and take effect for new redemption sessions.Member experience
Members access the Plum catalogue from the member-facing app or web portal. The flow:- Member taps Redeem Points or navigates to the rewards catalogue.
- The app initiates an SSO handoff to Plum using the member’s active session.
- Member lands on Plum’s catalogue, already authenticated, with their available redemption balance shown.
- Member selects a voucher or gift card and confirms the redemption.
- Points are debited from the member’s Loyalife account.
- The voucher or gift card is delivered to the member (via email or in-app).
Minimum redemption threshold
You can set a minimum number of points a member must have before Plum redemption is available to them. Configure this under Configuration → Marketplace Settings.Member status and redemption
Only Active members can redeem through Plum. Members with Inactive, Suspended, Blocked, or Cancelled status cannot initiate a redemption session.Troubleshooting
Member cannot access the Plum catalogue (session error).- Verify the SSO Token is valid and has not expired. Contact the Loyalife implementation team to rotate if needed.
- Confirm the member’s status is Active.
- Check the current rate in Configuration → Marketplace Settings.
- Verify the Redemption Rate Token is correctly configured and not stale.
- Check Plum’s order status for the transaction reference.
- Redemption-related disputes between members and Plum should be raised with the Plum support team, providing the transaction reference from the member’s Loyalife transaction history.
Every successful Plum redemption generates a Debit By Redemption entry on the member’s ledger. If a redemption is subsequently reversed (e.g., unfulfilled voucher), the restored points appear as a Redemption Reversal credit. Both entry types are filterable in Transactional reports under Reports & Analytics → Transaction Category.