↑↓ selectEnter openEsc close

    1. Elbuz
    2. Sales and documents
    3. In-store POS
    4. Card payment at the till: terminal, smartphone or QR

    Terminal by mono at the till: take card payments on a smartphone

    3 min readUpdated

    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

    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.

    1. In monobank, connect Terminal by mono for the till's smartphone — the bank shows a terminal numbered MT….
    2. In Elbuz, turn on monobank in “External services” → “Payment” and enter the “Token (X-Token)” from web.monobank.ua. More: connecting monobank.
    3. Open the “POS” window → the “Till settings” gear → your till.
    4. In the “Smartphone terminal (“Terminal by mono”)” field, choose the MT… terminal and click “Save”.
    5. Reopen the till — the “Terminal” button (F10) appears on the right.
    Till form in Till settings: the Terminal by mono field with terminal MT000777 and an empty PrivatBank client key field
    1Terminal by mono
    2PrivatBank key is empty
    1. The monobank terminal of this till — the list comes from monobank.
    2. 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

    1. Scan the products and add a customer, promo code or points if needed.
    2. Click “Terminal” (F10). A window opens with the amount, the “Open terminal” button and the “Customer is not paying — cancel” button.
    3. Click “Open terminal”: Terminal by mono opens with the receipt amount. The customer taps a card or phone.
    4. 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”.
    The Terminal window at the till: amount 825.00, the Open terminal button, a hint and Customer is not paying — cancel
    1Amount due
    2Open terminal
    3Hint
    4Customer is not paying — cancel
    1. The receipt amount the bank app will charge.
    2. Opens the bank’s “Terminal” app on this smartphone with the amount filled in.
    3. The window waits for the payment and closes by itself when the bank confirms it.
    4. 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.”

    A payment that arrives after cancelling is recorded as a cash receipt in the shift, but the sale isn't posted. Check it in monobank and either refund the customer or ring up the sale again.

    What appears in documents and the shift report

    DocumentWhat it shows
    Customer order and sales receiptCreated right away, unposted, with the status “Awaiting payment”. After payment they're posted and get “Done”; after a decline or cancelling — “Canceled”
    Cash receiptPayment 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 receiptOnly 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

    Terminal by mono messages
    What you seeWhyWhat 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

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free