PromptPay and QR payments
Show a QR code for PromptPay, Alipay, WeChat Pay, or crypto and mark as paid on confirmation
Overview
QR-based payments all follow the same shape: the cashier picks the method, the iPad displays either a QR code (for PromptPay) or a "wait for payment" prompt (for Alipay, WeChat Pay, Crypto), the customer pays in their own app, and the cashier taps Order Paid once the transaction lands.
PromptPay is the only method that renders a live QR on the iPad โ Klu generates it from the organization's registered PromptPay ID and encodes the exact order total into the payload. Alipay, WeChat Pay, and Crypto display a waiting prompt only โ the merchant handles the QR or wallet flow on their own device.
When to use it
- Thai customers paying via their bank app (PromptPay)
- Chinese tourists paying via Alipay or WeChat Pay
- Crypto-paying customers (merchant must verify receipt externally)
How to use it
Video tutorial coming soon
- On the Complete Order screen, tap Prompt Pay, Alipay, WeChat Pay, or Crypto.
- For Prompt Pay: a large QR code renders in the center of the panel โ the total is encoded in the payload. Rotate the iPad so the customer can scan with their bank app.
- For Alipay, WeChat Pay, or Crypto: the panel shows a waiting prompt โ process the payment on the merchant's separate QR or wallet device.
- Once the customer confirms in their app and the merchant has verified the receipt, tap Order Paid on the right โ Klu finalizes the sale and routes to Print Receipt.
Tips & gotchas
- PromptPay ID must be configured on the organization โ if it isn't set, the QR panel shows "PromptPay is not enabled" instead of a code. Set it in the Dashboard organization settings.
- The PromptPay QR is amount-locked โ it encodes the exact total. If you cancel and re-create the sale, the old QR is invalid; always use the one on screen for the current sale.
- Alipay / WeChat / Crypto do not generate a QR on the iPad โ Klu only records the method. The customer's payment happens entirely in your merchant's own ecosystem.
- Wait for the customer's own app to show "paid" before tapping Order Paid โ sometimes there's a 10-30 second delay between scan and settlement.
- The QR on screen is dynamic and single-use โ don't screenshot it for a later sale; re-open Complete Order to regenerate for each bill.