Cash Conversion
“Cash conversion” is redemption: a member with 12,000 GSPTS pays RM 120 of a RM 349 pair of
wireless earbuds with points and the rest by card. It happens in
POS General, in one of two ways the applet page
documents: a member-points settlement (points ↔ cash value, with a maximum), or a
points-discount line carried by the MEMBER_POINT_DISCOUNT adjustment item. At FINAL the
backend checks the redeemed points against the member’s balance and writes a REDEEM line.
Where to do this
Nothing on this page is set in Membership Admin beyond the currency and the rate. The counter configuration is POS General’s:
| Setting | Where in POS General | Why |
|---|---|---|
SHOW_MEMBER | Settings (see the POS General page) | Shows the member panel at all |
Points Discount Item Code (POS_DEFAULT_POINTS_DISCOUNT_GUID) | Default Selection | The item that carries a points redemption as a line; without it the line cannot be added |
POS_ALLOW_VERIFIED_MEMBER_REDEEM_POINTS | Settings | Only members with Verification Status verified may redeem |
POS_SHOW_MEMBER_POINT_DISCOUNT_POINT_LISTING, POS_SHOW_MEMBER_POINT_DISCOUNT_Z_REPORT | Settings | Points-discount columns in the listing and the Z Report |
The MEMBER_POINT_DISCOUNT item itself is created in
Doc Item Maintenance (item type Member Point Discount).
What the backend does
- At FINAL the redeemed points must be within the balance (
validateRedeemedPointsBalance, POS General page); the bill’s point lines becomeREDEEMtransaction lines and the balance is updated by the queue. - On VOID the bill’s point lines are reversed; if the balance is now short, an adjustment line
is added for the shortfall (
MembershipCtrlAccAndCurrentBalanceService.voidMembershipPoints, L167–L200). - Nothing posts to the ledger from the points. The cash bill posts what it always posts; the points settlement or discount line is part of that bill.
Decide before you switch it on
- Whether unverified members may redeem. GadgetSphere requires verification, because a member created at the till from a phone number is otherwise a balance anyone can spend.
- A maximum per bill, if the business wants one — the settlement panel supports a maximum.
- Whether redemptions should be visible in the Z Report; supervisors reconciling a drawer usually want them.
When it goes wrong
| Symptom | Cause | Fix |
|---|---|---|
| Points discount missing at the counter | Points Discount Item Code not set, member not verified, or no points-to-money rate | POS Default Selection; verify the member; PTS to CCY Config |
| FINAL rejected on a bill with points | Redeemed points exceed the valid balance | Reduce the points; check the Points Expiry tab for lots that have expired |
| Balance looks wrong after a void | The void added an adjustment for a shortfall | Point Transaction tab shows the adjustment line |