Vouchers (Create Voucher)

Use this page when you need to create a voucher on the till — a store-credit or gift-style voucher the customer can redeem against a future sale.

Goal

You need to purchase a Kazang-style voucher at the till — pick a value, take the payment, and give the customer the voucher reference. (A free-form store-credit / gift voucher flow is not implemented in the till today; see the note at the bottom of this page.)

Where this happens

• On the till (Retail POS App): open Create Voucher from the till Current Sale screen (the CreateVoucher() action pushes to route /CreateVoucher).

The Create Voucher screen is reached from the till's current-sale panel, not from the home drawer.

Prerequisites

• You are signed in to the Retail POS till.
• The customer has chosen a voucher value (the screen shows three pre-set card options today).

Steps

1. Open Create Voucher from the sale

From the till's current-sale panel, trigger the Create Voucher action. The till navigates to route /CreateVoucher (screen title Select Vouchers).

2. Pick the voucher card

The screen today shows three voucher cards (placeholders — Card 1 / Card 2 / Card 3 at $10 / $20 / $30). Tap the card for the value the customer wants.

3. Confirm purchase (modal)

A Voucher Purchasing Screen modal opens for Confirm Purchase. It asks for:

1. Phone Number for the customer's voucher reference.
2. Payment Method.
3. Amount Paid.

Save to complete the purchase.

Note: the underlying flow is in active development — fields and labels may change. Verify against the on-screen modal in your store before relying on the steps above.

Expected result

• The voucher purchase is logged against the customer's phone number on the till.

Edge cases

• You cannot find Create Voucher on the till. Use the current-sale panel on the Retail POS till. Restaurant POS does not expose a Create Voucher screen today.
• The voucher card values shown don't match what the customer asked for. The screen is fixed-card today; tell the customer the available values, or ask your supervisor.
• The voucher purchase modal asks for a value the customer did not agree to. Re-open the card and re-enter the agreed amount in Amount Paid. Do not change the voucher value to match an unconfirmed total.
• The voucher value is above the approval threshold. Ask a supervisor to approve before creating; do not split the voucher to dodge approval.
• A voucher is lost. Tell the customer to contact Support with the original reference number. If they do not have the reference, the franchise admin can look it up by date and value.

Implementation note: the free-form Store credit / Gift voucher distinction that earlier versions of this page described is not implemented in code today — the till renders a fixed-card placeholder for voucher purchasing. Until the flow ships, do not promise store-credit or gift-voucher creation at the till; tell the customer what is on screen.

Related

• Sales
• Refund
• Customers
• Cash-up & finance