Payments and Transactions
- Introduction
- Payment Modes
- The Transactions Page
- M-Pesa
- Kopo Kopo
- Co-operative Bank
- Equity Bank
- Payment Capture from a Phone
- How a Received Payment Is Used
- Marking a Payment as Used
Introduction
When a customer pays by M-Pesa or bank, the money goes to your account, not to the till. Hotel360 keeps a list of those incoming payments so a cashier can pick the right one when clearing a bill. The Transactions page shows that list. It needs the Open Transactions permission and sits under Office > Transactions in the sidebar.
Which channels you see depends on what your business has connected under Administration > Payment Integrations. Connecting a channel is usually done once, by the owner or Hotel360 support. See Users, Roles and Settings.
Payment Modes
A payment mode is a way of paying, such as Cash or Card. The list is in Administration > Settings, in the Payment Modes card.
- Cash, M-Pesa, Co-op Bank, Kopo Kopo and Equity Bank are Default modes. They cannot be edited or removed (Default payment modes cannot be removed.).
- To add your own, type a name such as "Card" or "Bank Transfer" and press Add. You see Payment mode added. If the name is already taken: A payment mode with this name already exists.
- Your own modes have Edit and Remove buttons.
The same list feeds every place where money is taken or paid out: the bill Payment Method, supplier payments, expense payments, lodge and service payments. Cashiers see Cash only if they have the Accept cash permission. For how each method behaves on a bill, see Working with Bills.
The Transactions Page
The page has one tab for each connected channel: Co-operative Bank, Kopo Kopo, M-Pesa, Equity Bank. It opens on the first one in use. If nothing is connected you see No payment integrations yet, with a pointer to Administration > Payment Integrations.
Reading a Statement Tab
Every tab works the same way:
- Three boxes at the top: Total Received, Used and Available. They follow your filters. Available is what has come in but not yet been used to pay a bill.
- A search box, a status filter, and From Date, From Time, To Date, To Time.
- A list, 20 rows per page. Newest first.
Status tells you how much of a payment has been used:
| Badge | Meaning |
|---|---|
| Unused (or Available) | Nothing taken from it yet |
| Partly used with "KES 500.00 left" | Part of it paid a bill, the rest is still open |
| Used (or Fully Used) | Nothing left |
| Used (marked) | Used up by hand without a bill, see Marking a Payment as Used |
M-Pesa
The M-Pesa tab appears when M-Pesa is connected (Daraja) or when a phone is forwarding payment messages (see Payment Capture from a Phone).
- Search by transaction id, account, or name.
- Filters: status (All Status, Unused, Partly used, Used) and source (All Sources, API, SMS, Pasted).
- Columns: Transaction ID, Customer, Account Number, Amount, Type, Source, Status, Date.
- The Source badge says how the payment got in: API (straight from Safaricom), SMS (from a capture phone) or Pasted (typed in by an admin).
- ⋯ > View details shows the amount, what is Available, who paid, the date, the Original message, and Bills paid with it.
On the bill, M-Pesa works two ways: Search Transaction (pick a payment that already arrived) or STK Push (send a prompt to the customer's phone). STK Push needs the M-Pesa connection to have a Passkey (STK Push) saved. Without it, only searching is offered.
In Administration > Payment Integrations > M-Pesa the owner enters the Shortcode, Shortcode Type (Paybill (has account number) or Till / Buy Goods), Consumer Key, Consumer Secret, optional Passkey (STK Push) and Environment. For a Buy Goods till the Store Number is also needed. After saving, the Register C2B URLs button tells Safaricom where to send payments.
Kopo Kopo
The Kopo Kopo tab is for M-Pesa Buy Goods tills collected through Kopo Kopo. Payments arrive by themselves. An hourly Auto-sync catches any that were missed.
- Search by code, phone or name. The phone is partly hidden.
- Status filter: Available, Partially Used, Fully Used.
- If you have several tills, a Filter by till list and a Per till table showing Received, Used and Available for each.
- Columns: Date, M-Pesa Code, Till, Customer, Phone, Amount, Status.
- Export to Excel and Print use the current filters.
On a bill, Kopo Kopo offers STK Push and Search Transaction. With more than one till, the cashier picks the Till first. Extra tills are added in Administration > Payment Integrations > Kopo Kopo under Additional tills (a Till Number and an optional Label such as "Bar").
Co-operative Bank
The Co-operative Bank tab lists credits from your Co-op Bank account (paybill and till payments).
- Search, status filter (Fully Used, Available, Partially Used) and All Accounts.
- Columns: Transaction ID, Customer Name, Amount (with Remaining when part is used), Reference, Payment Ref, Bill Number (the bills it paid), Status, Date.
- Export to Excel and Print use the current filters.
Payments normally arrive on their own, and Auto-sync in the integration settings pulls the statement every hour. If one is missing, press Query Statement. In the window, choose Start Date and End Date, press Query Statement (it may take up to 90 seconds), then Sync to Database to save what was found.
On a bill, Co-op Bank offers STK Push, Search Transaction and Hold for Verification (see Working with Bills). Each department has its own Paybill account code. A payment made to another department's account is refused with That payment was made to the Lounge till and cannot clear a bill on this one.
Equity Bank
The Equity Bank tab lists payments received through Equity.
- Search by reference, bill or name. Filters for status and source (API, SMS, Pasted), and the date and time range.
- Columns: Date, Bank Reference, Bill No., Customer, Amount, Source, Status.
- ⋯ > View details and Mark as used, as for M-Pesa.
On a bill, choose Equity Bank, type a Reference / Bill / Name (at least 3 characters) and pick the payment.
The owner connects Equity in Administration > Payment Integrations > Equity Bank. Equity gets a username, a password and four web addresses (Token URL, Token refresh URL, Validation URL, Notification URL) that the page shows. The Signing secret is internal and must never be shared with Equity.
Payment Capture from a Phone
If your business has no M-Pesa or Equity connection, a phone can do the job. The phone that receives your M-Pesa and Equity payment messages forwards them to Hotel360. Each message becomes a payment the cashiers can pick.
- On that phone, open the Hotel360 app and go to Settings > Payment capture to register it. This needs the Register phones for M-Pesa SMS capture permission. See The Hotel360 Phone App.
- In Administration > Payment Integrations > SMS Capture you see each phone: Phone, Registered by, Last seen, Payments (how many it captured) and Status.
- A phone not heard from for 6 hours shows a Quiet badge. Check that the phone is on, online and the app may run in the background.
- To stop a phone, use ⋯ > Deactivate and confirm. It then cannot send payments (Phone deactivated. It can no longer send payments.).
Under Messages that were not recorded you see up to 20 recent messages that could not be used:
- Not recognised: the wording is new. Report it to support, and add the payment meanwhile (see below).
- Possible fake: it read like a payment but did not come from M-Pesa or Equity. Check your M-Pesa statement before accepting it.
Pasting a Missed Message
If the capture phone missed a message, an administrator can add it by hand. This needs Register phones for M-Pesa SMS capture.
- On Transactions, press Paste payment message.
- Copy the whole message from the phone that got the money and paste it in.
- Press Add payment. You see Payment added. It is now available to clear bills. The payment shows with the Pasted badge.
Errors you may see:
- This payment is already recorded.
- This is not an M-Pesa or Equity "payment received" message.
- This looks like a payment, but its wording is not recognised yet. Please report it.
How a Received Payment Is Used
When a cashier clears a bill with Search Transaction, Hotel360 does three things:
- It checks the payment still has money left. If not: The selected M-Pesa transaction has no remaining balance.
- It checks the amount for the bill does not exceed what is left: The total amount (KES 2,000.00) exceeds the transaction remaining balance (KES 1,500.00).
- It records the receipt against the bill and subtracts the amount from the payment.
So one payment can pay several bills, a bit at a time, until it is used up. Example: a customer sends Ksh 2,000. A bill of Ksh 1,200 is cleared with it, and the payment shows Partly used · KES 800.00 left. Another bill of Ksh 800 then clears it fully.
The payment's View details lists Bills paid with it. The bill's own Payments table shows the payment reference.
Marking a Payment as Used
Sometimes money arrives that is not for a bill, such as a deposit or an owner's transfer. If it stays Unused, a cashier might attach it to the wrong bill. Mark it as used. This needs the Mark an M-Pesa or Equity payment as used without a bill permission.
- On the M-Pesa or Equity Bank tab, click ⋯ > Mark as used on the payment.
- Type a Reason (3 to 500 characters), for example "Owner's transfer for supplies".
- Press Mark as used. You see Payment marked as used.
The rest of the payment is no longer offered when clearing bills. The status shows Used (marked) and the details show who did it and why.
To reverse it, choose ⋯ > Undo "marked as used" and confirm Make this payment available to clear bills again? You see Payment is available again. Bill payments already taken from it are never changed.
Note
Mark as used is only for M-Pesa and Equity payments. It does not appear once the payment is fully used.