The Elbuz till sends the receipt amount to Terminal by mono on a smartphone. The customer taps a card or phone; Elbuz posts the sale, stock and receipt once monobank confirms.
When you need this:
- No separate terminal — the till's smartphone or tablet with NFC takes cards through the monobank app.
- Cashiers mistype amounts — the amount comes from the receipt.
- Post only paid sales — until the bank responds, the sale stays a draft.
- The bank declined — the sale is cancelled, the products stay on the receipt.
Where to start: choose an MT… terminal in the till settings.
What Terminal by mono can do at the till
- Amount from the receipt — the app opens with the right amount and the till's terminal.
- Automatic posting — stock, points, promo code and the PRRO receipt once the bank confirms.
- Declines and cancelling — the sale isn't posted, the products stay on the receipt.
- Payment details in the cash receipt — RRN, authorization code and masked card number.
How to connect Terminal by mono to the till
Elbuz is already registered with monobank as a POS developer. All you need is a connected monobank and a chosen terminal.
- In monobank, connect Terminal by mono for the till's smartphone — the bank shows a terminal numbered MT….
- In Elbuz, turn on monobank in “External services” → “Payment” and enter the “Token (X-Token)” from web.monobank.ua. More: connecting monobank.
- Open the “POS” window → the “Till settings” gear → your till.
- In the “Smartphone terminal (“Terminal by mono”)” field, choose the MT… terminal and click “Save”.
- Reopen the till — the “Terminal” button (F10) appears on the right.
1
Terminal by mono2
PrivatBank key is empty- The monobank terminal of this till — the list comes from monobank.
- A till has only one phone terminal.
The field appears when monobank is connected in “Payment”; Elbuz takes the terminal list from your monobank using the payment service token. To disconnect the till from the terminal, choose “— no terminal —”.
A till can have only one smartphone terminal. If this till has a PrivatBank key, click “Remove key” first.
How to take a payment
- Scan the products and add a customer, promo code or points if needed.
- Click “Terminal” (F10). A window opens with the amount, the “Open terminal” button and the “Customer is not paying — cancel” button.
- Click “Open terminal”: Terminal by mono opens with the receipt amount. The customer taps a card or phone.
- Go back to the till. The window checks the payment every 5 seconds and closes on its own once the bank confirms, and the sale number appears in “Last receipt”.
1
Amount due2
Open terminal3
Hint4
Customer is not paying — cancel- The receipt amount the bank app will charge.
- Opens the bank’s “Terminal” app on this smartphone with the amount filled in.
- The window waits for the payment and closes by itself when the bank confirms it.
- Cancels the payment; the products stay in the receipt.
Until the bank confirms the payment, the sale is an unposted draft with the status “Awaiting payment”: no stock write-off, no points, the promo code unused. All of this happens at confirmation, together with the PRRO receipt if a fiscal register is connected to the till.
Payment is in hryvnias only: the “Terminal” button is shown only when the account's main currency is the hryvnia. The bank gets the amount and the purpose “Payment for purchase <number>” — the product list isn't sent to the app.
The bank declined or the customer isn't paying
If the bank declines, for example because of insufficient funds, the till shows “Card payment failed (…): sale … cancelled, the items stay in the receipt.” The draft gets “Canceled”, and the cashier takes payment another way.
If the customer changed their mind, click “Customer is not paying — cancel”.
The till checks with the bank first: if the payment has already gone through, the sale is posted, not cancelled. If not — “Card payment via the terminal was cancelled: sale … was not completed.”
What appears in documents and the shift report
| Document | What it shows |
|---|---|
| Customer order and sales receipt | Created right away, unposted, with the status “Awaiting payment”. After payment they're posted and get “Done”; after a decline or cancelling — “Canceled” |
| Cash receipt | Payment type “Card at terminal”; the description has the till, the sale number, Термінал by mono (Terminal by mono), the RRN, the authorization code and the masked card number. Posted right away |
| PRRO fiscal receipt | Only when a fiscal register is connected to the till: the payment form is card |
In the X report and the shift closing report, this money is in the “Card” line — together with payments on a separate terminal. More: X report.
Scenarios
The store already takes payment links through monobank
What to turn on. Terminal by mono in monobank and an MT… terminal in the till settings.
What you get. Two buttons at the till at once: “QR” for payment from the customer's phone and “Terminal” for cards.
The card is declined
What to do. Nothing needs cancelling: “Cash” or “Card” with the same receipt.
What you get. The declined draft stays cancelled, and the sale goes through with the new payment method.
Two tills, two smartphones
What to turn on. Each till gets its own MT… terminal.
What you get. Payment from each till goes to its own terminal, and sales go to its own shift.
What to do when a payment doesn't go through
| What you see | Why | What to do |
|---|---|---|
| “monobank did not return the terminal list (HTTP …): check the token in the monobank payment service.” | The token in the monobank payment service is wrong or revoked | Enter a valid token in “External services” → “Payment” → monobank |
| “The phone terminal is not set up: …” | The monobank service was turned off or the terminal was removed from the till | Turn the service on and choose the terminal in the till settings |
| “A till can have only one phone terminal.” | The till already has a PrivatBank key | “Remove key” and save the till |
| “A gift card and the phone terminal cannot be combined in one sale: …” | The receipt has a gift card | Take the remainder in cash or by “Card” |
| “The bank reported a different amount (…) — the sale was not completed; check the payment in the bank account.” | The payment amount or currency doesn't match the receipt: the sale isn't posted, the window closes, the products stay on the receipt | Check the payment in monobank: if the money was charged, refund the customer there and ring up the sale again |
FAQ
The till is on a computer and monobank on a phone. Will that work?
No: “Open terminal” opens the app on the same device. Work in the till on a smartphone or tablet with NFC.
How is “Terminal” different from “QR” with the same monobank?
“Terminal” — the customer taps a card on the till's smartphone. “QR” — the customer scans a code and pays from their own phone.
How do I refund a customer?
Process a return at the till with the “Card” method, and refund the money itself in monobank: Elbuz doesn't send refunds to the bank.
Do I need to enter Elbuz keys?
No: the Elbuz POS developer key is already built in. All you need is the monobank service token and a chosen terminal.
The till window was closed before payment. Will the sale be lost?
No: monobank notifies Elbuz about the payment, and the sale is posted on its own. If the notification didn't arrive, the sale is posted the next time the till is opened: on opening, it checks up to five recent unpaid terminal drafts from the past 24 hours.
Where it is and who has access
- Menu
- “Directories” → “Documents” → “POS” → “Terminal” (F10)
- Settings
- the “Till settings” gear → till → MT… terminal
- Access rights
- payment — anyone with access to the till; terminal — the “Till settings” right
- Prepare
- the monobank payment service, Terminal by mono on the till's smartphone, the hryvnia as the account's main currency
Related topics
- If you're choosing how to accept cards — Card payment at the till.
- If monobank isn't connected yet — Payment links.
- If a customer returns a product — Returns at the till.
