> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centipidbilling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voucher agents

> Create prepaid voucher sellers, manage float and stock, and reconcile redemption performance.

# 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.