The Elbuz till sends the receipt amount to the “Terminal” app, and the smartphone works as a PrivatBank terminal. Elbuz posts the sale, stock and receipt once the bank confirms.
When you need this:
- No separate terminal — the till's smartphone or tablet with NFC takes cards through the bank's 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: paste the client key into the till settings.
What the PrivatBank “Terminal” can do at the till
- Amount from the receipt — the app opens with the right amount.
- 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” to the till
Elbuz is already registered with PrivatBank as a POS developer — all you need is a client key.
- Connect the “Terminal” service at PrivatBank and install the “Terminal” app on the smartphone or tablet the till will run on.
- In your terminal.pb.ua account, open «Інтеграція» (Integration) and create a key. Copy it.
- In Elbuz, open the “POS” window → the “Till settings” gear → your till.
- Paste the key into the “PrivatBank “Terminal” — client key” field and click “Save”.
- Reopen the till — the “Terminal” button (F10) appears on the right.
1
Terminal by mono2
PrivatBank key3
terminal.pb.ua hint4
Remove key- monobank terminal — empty: a till has only one phone terminal.
- The client key from terminal.pb.ua; an empty field keeps the saved key.
- Where to get the client key.
- Removes the key from the till; save the form after that.
A saved key isn't shown even to an administrator: the field reads “Key saved — enter a new one to replace it”. To replace the key, paste a new one; to disconnect the till from the bank, click “Remove key” and “Save”. Saving with an empty field doesn't erase the key.
A till can have only one smartphone terminal. If Terminal by mono is already chosen for this till, set it to “— no terminal —” 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”: the PrivatBank app 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.
1
Last receipt2
Terminal button- The sale posted after the bank confirmed the payment: number, amount, order and receipt.
- Next card payment through the smartphone — F10.
PrivatBank accepts payments from UAH 1.00 and only in hryvnias: 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, Термінал ПриватБанку (PrivatBank Terminal), 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.
Fiscal receipt: from Elbuz or from the bank
The receipt can be issued by the till's PRRO in Elbuz or by PrivatBank itself, if fiscalization is turned on in your “Terminal” account. Choose one: when both are on, one sale gets two fiscal receipts.
- The bank handles fiscalization — in the Elbuz till settings, choose “No fiscal receipt” in the “Fiscal register” field.
- Elbuz handles fiscalization — turn fiscalization off in your “Terminal” account. How to connect a PRRO to the till: How to set up a till.
Scenarios
A coffee shop, the till on a tablet
What to turn on. The “Terminal” app on the tablet and the client key in the till settings.
What you get. The cashier presses F10, the customer taps a card on the tablet, and the sale and receipt are posted on their own.
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, one “Terminal” account
What to turn on. The key in each till, the app on each smartphone.
What you get. Each till opens the app on its own device, and sales go to its own shift.
What to do when a payment doesn't go through
| What you see | Why | What to do |
|---|---|---|
| “The PrivatBank client key is Latin letters and digits without spaces: copy it from the terminal.pb.ua account.” | Extra text or spaces got into the field | Copy the key from «Інтеграція» (Integration) again and paste it unchanged |
| “A till can have only one phone terminal.” | Terminal by mono is already chosen for the till | Set “— no terminal —” in the mono field and save |
| “PrivatBank did not create the payment: …” | The bank didn't accept the key or the “Terminal” service isn't active; the bank's response follows the colon | Check your terminal.pb.ua account and paste a new key; the products are still on the receipt |
| “PrivatBank accepts payments from UAH 1.00.” | The receipt amount is less than UAH 1 | Take the payment in cash |
| “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 at the bank doesn't match the receipt amount: the sale isn't posted, the window closes, the products stay on the receipt | Check the payment in your “Terminal” account: if the money was charged, refund the customer there and ring up the sale again |
FAQ
The till is on a computer and the app on a phone. Will that work?
No: “Open terminal” opens the app on the same device. Work in the till on the smartphone or tablet where “Terminal” is installed.
After payment, an “Elbuz: …” page opened. What is it?
The bank's app brings the cashier back to Elbuz. “Payment received, sale completed” — go back to the till tab; “checking the payment” — the till will post the sale as soon as the bank confirms.
How do I refund a customer?
Process a return at the till with the “Card” method, and refund the money itself in the “Terminal” app or account: Elbuz doesn't send refunds to the bank.
Do I need to enter any other Elbuz keys?
No: the Elbuz POS developer key is already built in. All you need is the client key.
The till window was closed before payment. Will the sale be lost?
No, the draft stays. When the app brings the cashier back to Elbuz, the till checks the payment and posts the sale. If the cashier didn't return to the till, 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 → client key
- Access rights
- payment — anyone with access to the till; key — the “Till settings” right
- Prepare
- the PrivatBank “Terminal” service, the app 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 a customer returns a product — Returns at the till.
- If you need a fiscal receipt from Elbuz — How to set up a till.
