Docs › Agents
Agents
Selling Vouchers Through Agents
Agents are people who sell your vouchers for cash, such as a shop owner or hostel caretaker. Each agent signs in on their phone, makes vouchers that only work at their location, and the system keeps track of what they sold and what they owe you.
1
Add a location
Go to Agents → Locations → Add location. Give it a name and tick the router or routers at that site. Vouchers made for this location will only log in on those routers. On any other router the customer sees "This voucher only works at the location it was sold for."
2
Add the agent
Go to Agents → Add agent. Enter their name, phone number and a 4–6 digit PIN, and choose their location(s) and the packages they may sell. You can also set:
- Commission: a percentage or fixed amount per voucher sold, or none.
- Max unpaid amount: the most an agent can owe you, counting unpaid sales and the unsold vouchers they hold. Once they reach it they can't get more vouchers until they pay in. We recommend setting one.
- Max vouchers per day, and whether they can generate vouchers themselves. Turn this off if you want to hand out every voucher yourself.
- I approve each request first: the agent's vouchers aren't made until you approve them (see step 4).
3
The agent signs in
Send the agent your agent sign-in link, https://yourname.billing.ioxsolution.com/admin/agent/login, with their phone number and PIN. From their phone they can make vouchers, print or share the codes, and see what they owe. You can also give an agent vouchers yourself from their page with Give vouchers.
4
Approve requests and get alerts
For agents set to I approve each request first, a request appears at the top of Agents under Waiting for your approval, and the menu shows how many are waiting. Click Approve to make the vouchers, or Decline with an optional reason the agent will see. If approving would take the agent over their limit, tick Give anyway. You get an SMS, email and WhatsApp message for each request, sent to the Admin Phone and Admin Email in Settings → Notifications → Agent Alerts. WhatsApp only works if it's set up in your Settings. There you can also choose to be alerted whenever an agent makes vouchers without approval. The agent gets a text when you approve or decline their request.
5
A sale is counted when the customer logs in
An agent's voucher counts as sold the first time a customer logs in with it. At that point the price, minus the agent's commission, is added to what the agent owes. Unused vouchers are not counted as sales.
6
Record cash you receive
When an agent pays you, open their page and use Record payment (cash, mobile money, bank or other). The amount owed drops straight away. If you make a mistake, use Reverse rather than deleting. That keeps a clear record.
7
Check the report
Agents → Report shows vouchers given, vouchers sold, sales, commission, cash received and amount owed, by agent and by location, for today, this week, this month or any dates you choose. You can download both tables as CSV.