Sell prepaid water credit at the counter
Take the customer's money, see how many litres it buys on the active tariff, and hand over the token to enter on the prepaid meter.
Updated on
At the counter, staff take the customer's payment, the dashboard turns the amount into litres on the account's tariff, and returns a token the customer enters on the meter. Selling credit needs the Billing clerk, Finance, Administrator or Owner role; switching a meter to prepaid is done by Operations, Administrator or Owner.
Before you start#
- The meter is registered and linked to an account. A meter with no account cannot become prepaid.
- The account's category has an active tariff, since the tariff sets the price of each litre.
- Your utility has at least one counter payment method configured. Methods that ask for the payer's phone number are not offered for this sale.
Step 1: Switch the meter to prepaid#
Do this once per meter.
- In the Billing menu, open Prepaid.
- Click Activate meter.
- Under Meter, use Choose meter to select it.
- Click Activate. The meter shows in the Meters table as Active and is no longer included in monthly billing.
Step 2: Work out the volume#
- On Prepaid, click Sell credit. The button only appears once at least one meter has been switched to prepaid.
- Under Meter, pick the customer's meter. Only meters with the status Active are listed.
- Under Amount (MT), type what the customer is paying.
- When you leave the field, the dashboard shows how many litres the amount buys. The month's first purchase also covers the tariff's fixed charge, where there is one, so it buys fewer litres than later purchases.
Step 3: Charge and hand over the token#
- Under Payment method, pick how the customer paid.
- Click Charge and issue token.
- The dialog changes to Sale completed. Read out the code under "Enter this token on the meter:" or give the customer the Receipt PDF.
What happens next#
The sale is added to the Sales list with the status Issued, the amount, the litres and the token. Opening the row splits the amount paid into Water, Sanitation and Tax. Money left over that does not reach a whole litre stays as Wallet remainder and counts towards the meter's next purchase. The payment is recorded on the customer's account with a receipt number. Residents whose account holds the meter can also buy credit in the portal under Prepaid water and see their Previous purchases.
Common problems#
- "Could not calculate the volume for this amount." The amount does not cover a single litre, or the account's category has no active tariff. Ask for a larger amount or check the tariff.
- "Could not complete the sale." The token generator is unavailable or the payment was not recorded. If the sale was created, it shows under Sales as Failed with no token. When the token step failed, the payment is already recorded on the customer's account, so check the list and the account before charging again.
- The meter is missing from the list. Either it has not been switched to prepaid yet, which someone with the Operations role can do in step 1, or it is Suspended. The dashboard has no button to resume a suspended meter: someone with the Operations, Administrator or Owner role resumes it through the API with
POST $BUSINESS_API/prepaid/meters/{id}/status. - "No payment methods are configured for this utility yet." Only the Owner and Administrator see the Configure collection channels link. Ask one of them to add a counter method such as cash.