Skip to content

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:

SettingWhere in POS GeneralWhy
SHOW_MEMBERSettings (see the POS General page)Shows the member panel at all
Points Discount Item Code (POS_DEFAULT_POINTS_DISCOUNT_GUID)Default SelectionThe item that carries a points redemption as a line; without it the line cannot be added
POS_ALLOW_VERIFIED_MEMBER_REDEEM_POINTSSettingsOnly members with Verification Status verified may redeem
POS_SHOW_MEMBER_POINT_DISCOUNT_POINT_LISTING, POS_SHOW_MEMBER_POINT_DISCOUNT_Z_REPORTSettingsPoints-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 become REDEEM transaction 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

SymptomCauseFix
Points discount missing at the counterPoints Discount Item Code not set, member not verified, or no points-to-money ratePOS Default Selection; verify the member; PTS to CCY Config
FINAL rejected on a bill with pointsRedeemed points exceed the valid balanceReduce the points; check the Points Expiry tab for lots that have expired
Balance looks wrong after a voidThe void added an adjustment for a shortfallPoint Transaction tab shows the adjustment line