# Take payments with QR Terminal

> Turn your phone or tablet into a payment counter. Key in the amount, show the QR code and your customer scans to pay.
>
> Source: https://docs.bcl.my/qr-terminal/

QR Terminal turns your phone, tablet or laptop into a payment counter. You key in the amount, BCL shows a QR code, and your customer scans it with their banking or e-wallet app. It suits events, booths and shop counters.

## Set up QR Terminal

Do this once, after you [connect your Bayarcash account](/connect-bayarcash/). Until then, the tab shows **Complete Bayarcash Configuration above** and its fields are locked.

1. Go to **Platform Setup** → **Payment** and open the **QR Terminal** tab.

   *(Screenshot: The QR Terminal tab of Payment Settings highlighted)*

2. In **Portal Key**, choose the Bayarcash portal that receives QR payments.
3. In **QR Payment Channels**, choose the channels to offer, such as **DuitNow QR**.

   *(Screenshot: The Portal Key field set to a portal and QR Payment Channels set to DuitNow QR, both highlighted)*

4. Optionally, add your own preset amounts in **Quick Amounts (RM)**. Leave it empty to use RM5, 10, 20, 50 and 100.
5. Click **Save QR Terminal Settings**. You see **QR Terminal settings saved successfully**.

   *(Screenshot: The Save QR Terminal Settings button highlighted)*

These settings are your own: each team member who uses QR Terminal saves their own portal and channels.

## Take a payment

With QR Terminal set up, take each payment like this:

1. Click **Quick Actions** → **QR Terminal**. You can also go to **Payments** → **QR Terminal** in the sidebar, or click **Open QR Terminal** on the settings tab.

   *(Screenshot: The Quick Actions menu with QR Terminal highlighted)*

2. Key in the amount on the keypad, or tap a quick amount such as **RM10**. The minimum is RM2.00. Tap **C** to clear the amount, or the arrow key to delete the last digit.

   *(Screenshot: The terminal with RM 10.00, with the amount and the quick amount buttons highlighted)*

3. Optionally, open **Customer (optional)** and add the customer's **Name**, **Phone** or **Email**.
4. If you offer more than one channel, choose one under **Payment Channel**. With one channel, the terminal uses that channel and does not ask you.
5. Tap **GENERATE QR** and show the code to your customer.

   *(Screenshot: The terminal with the Customer (optional) section filled in and the GENERATE QR button highlighted)*

The screen shows **Scan to Pay** with the amount, the DuitNow QR code, the order number and a countdown. The code is only valid for a short time, about a minute. While it shows **Waiting for payment…**, BCL checks for the payment by itself.

*(Screenshot: The Scan to Pay screen with the QR code, the order number and the countdown)*

When the payment arrives, you see **Payment Received** with the order number, channel and time, and a chime plays. Tap **NEW PAYMENT** for the next customer, or wait 8 seconds and the terminal resets itself. If the payment fails, you see **Payment Failed**. Tap **NEW PAYMENT** to start again.

> **Caution**
> QR Terminal always uses your connected Bayarcash account, even when **Test Mode** is on. Every QR code it shows is a real payment request, so test it with a small amount.

## If the QR code expires

When the countdown ends, you see **QR EXPIRED** and **No payment received for this code**:

- If your customer says they paid, tap **Customer already paid? Check status** first.
- Otherwise, tap **REGENERATE QR** to show a fresh code for the same amount.

*(Screenshot: The QR EXPIRED screen with the REGENERATE QR button and the Customer already paid? Check status link highlighted)*

You can also tap **CHECK STATUS** at any time while the code shows, or **CANCEL** to start again. BCL records every QR payment as a live payment, so it appears in [Transactions](/transactions/) when Test Mode is off. With Test Mode on, Transactions shows only test payments, so QR payments are not listed there.

## Common issues

### QR Terminal says it is not configured. What do I do?

Go to Platform Setup → Payment, open the QR Terminal tab, choose a Portal Key and your QR Payment Channels, then click Save QR Terminal Settings.

### The QR code expired but my customer says they paid. Did I lose the payment?

No. On the expired screen, click Customer already paid? Check status. BCL checks the payment again before you generate a new code.

### Can I change the quick amount buttons?

Yes. In the QR Terminal tab under Platform Setup → Payment, add your own amounts in Quick Amounts (RM).