💵 What is OGP Cash Refund?
When a customer has an OGP credit balance (from selling old gold to the shop) but decides they want some or all of it back as cash rather than using it to buy new jewellery, the shop can issue a partial cash refund — subject to admin-configured limits.
Important: OGP Cash Refund is a separate optional feature. The administrator must enable it with
ogp_cash_refund = Y. If it is disabled, the refund form is locked and no refund can be issued — the customer must use their OGP credit for a purchase.🛍️
Normal OGP Use
Customer uses OGP credit as payment when buying new jewellery. The shop is happy — no cash leaves.
✅ Always available — no admin setting needed
💵
OGP Cash Refund
Customer wants cash back instead of using OGP for a purchase. Cash is paid out, capped by admin limits.
⚙️ Requires admin to enable + set cap
Admin Controls the Refund Cap
The administrator sets a maximum refund cap in two ways:
Fixed Amount Cap
e.g. Rs. 5,000 maximum cash refund regardless of OGP total
Percentage Cap
e.g. max 20% of the OGP total can be refunded as cash
Try different cap settings to see how the maximum refund is calculated:
OGP Total
Rs. 48,500
Max Refund Allowed
Rs. 9,700
📋 Step 2: Review the OGP Record
This screen is accessed by opening a specific OGP receipt. It shows the original gold purchase details, how much has already been used as setoff in invoices, and how much is still available — before any refund is entered.
OG-A00042
⚡ Partially Used
Customer
SUNIL PERERA
Mobile
0771234567
Date
—
Total Weight
9.60g
OGP Total
Rs. 48,500.00
Available Balance
Rs. 33,500.00
Gold Items Received
| Category | Gold Type | Weight (g) | Amount (Rs.) | Description |
|---|---|---|---|---|
| Ring | 22K | 5.40 | 28,500.00 | LADIES GOLD RING WITH STONE |
| Bangle | 22K | 4.20 | 20,000.00 | BROKEN BANGLE |
| Total | 48,500.00 | |||
Setoff History — How OGP Was Used
OGP Balance Breakdown
Rs. 0Rs. 48,500
Used in Invoices: Rs. 15,000
Available for Refund: Rs. 33,500
The refund can only be applied against the remaining available balance — the OGP total minus any amounts already used in invoices. In this example, Rs. 48,500 − Rs. 15,000 = Rs. 33,500 available.
💵 Step 3: Enter Refund Amount
Enter how much cash to refund the customer. The amount is subject to two checks — it cannot exceed the available OGP balance, and it cannot exceed the admin-set refund cap.
OGP TOTAL
Rs. 48,500
USED IN INVOICES
Rs. 15,000
AVAILABLE BALANCE
Rs. 33,500
MAX REFUND CAP
Rs. 9,700
Set in Admin Panel per branch
Cannot exceed cap or available balance
Two rules apply simultaneously. The refund must be both:
≤ Available Balance
Cannot refund more than what's left
Cannot refund more than what's left
≤ Admin Refund Cap
Cannot exceed the configured limit
Cannot exceed the configured limit
If
ogp_cash_refund = N, the refund input is disabled and locked. The customer cannot get a cash refund at all from this branch and must use the OGP credit to purchase new jewellery.🔐 Step 4: OTP Verification
Before the cash refund is processed, a one-time password is sent to the customer's phone to confirm they authorise the refund. This protects against fraudulent refund requests.
The OTP is sent to both the customer's phone and a backup admin number. If the customer didn't receive the SMS, click Resend to Admin — the admin's phone has a copy of the same OTP and can relay it verbally.
OTP Verification — Cash Refund
A 4-digit OTP has been sent to 077****567.
Ask the customer to share the code they received.
Ask the customer to share the code they received.
OTP expires in 5:00
If the administrator has disabled OTP verification for refunds, this step is skipped and the refund is processed immediately after you click Proceed in the previous step.
OTP expires in 5 minutes. If it expires, re-submit the refund form to generate a new OTP. The system also prevents duplicate submission using a token — even if the form is submitted twice by accident, only one refund is recorded.
✅ Cash Refund Processed!
The refund is saved. The cash is paid to the customer, and the OGP balance is reduced by the refund amount. A refund receipt is generated and an SMS confirmation is sent.
📱 Customer SMS Confirmation
If SMS is enabled, the customer receives:
"Dear Customer, Your OGP refund of Rs. X for OGP No: OG-A00042 has been processed…"
"Dear Customer, Your OGP refund of Rs. X for OGP No: OG-A00042 has been processed…"
How the refund is recorded: The refund is saved as a negative amount in the payment records with type
OGP-REFUND, linked to the original OGP No. This means the remaining OGP balance is automatically reduced, and the full audit trail is maintained across all transactions.Remaining OGP balance after refund is still usable as setoff in future invoices — the refund only reduces the balance, it doesn't close the OGP entirely unless the full amount is refunded.
Voice Guide
Press Play to hear an explanation of this step.
Refund Summary
OGP NoOG-A00042
CustomerSUNIL PERERA
OGP TotalRs. 48,500
Used in InvoicesRs. 15,000
Available BalanceRs. 33,500
Refund CapRs. 9,700
Refund Amount—
After Refund Balance—
Refund No—
Key Rules
• Admin must enable cash refund
• Cannot exceed available balance
• Cannot exceed refund cap (fixed or %)
• OTP required (if enabled)
• Saved as OGP-REFUND negative
• Remaining balance still usable
• Cannot exceed available balance
• Cannot exceed refund cap (fixed or %)
• OTP required (if enabled)
• Saved as OGP-REFUND negative
• Remaining balance still usable
Quick Tips
• Check refund cap before entering
• OTP valid 5 minutes only
• Use Resend to Admin if needed
• Print receipt for customer
• Remaining OGP still usable
• OTP valid 5 minutes only
• Use Resend to Admin if needed
• Print receipt for customer
• Remaining OGP still usable