Voucher agents

Distribute vouchers through agents

Voucher agents are separate AGENT users with a reduced portal, prepaid float, assigned voucher batches, sales/redemption reporting, and a complete float ledger.

Create an agent

Required:

• name (maximum 120 characters);
• password (minimum 6 characters).

Optional:

• unique email;
• phone;
• initial float (zero or greater).

Use a unique account and deliver the temporary password securely. Agents should change it and enable available sign-in protection.

Float model

Float is the prepaid balance used to receive voucher stock. Issuing a batch debits:

package price × voucher quantity

Top-ups create ledger entries with actor, amount, balance after, description, and time. Add a useful note for cash/bank reconciliation; do not use an unexplained top-up to hide a prior error.

Issue stock

You can generate a new batch for an agent or assign existing stock. An existing batch is assignable only when it:

• has no agent;
• has not expired;
• uses a Hotspot package;
• has no redeemed voucher;
• can be covered by available float.

Batch assignment is atomic so two operators cannot safely issue the same stock. If the UI says a batch was just issued, refresh and choose another—do not retry with stale state.

Reconcile performance

The agent detail/report shows float balance, issued and available vouchers, sold/redeemed count, expired stock, revenue, redemption rate, sales by package, recent batches, trend, and float ledger.

Use the ledger as the money trail. A voucher is counted as sold/redeemed through code usage, not merely because it was assigned to the agent.

Password reset and removal

Sensitive actions are OTP-gated. Password reset produces a temporary 14-character password; share it securely and clear it from communication history.

Removing an agent leaves issued voucher batches valid because codes may already be in circulation, but clears the agent float/ledger relationship according to the current workflow. Reconcile stock and cash before removal.