Who is this for?
StoreHub merchants in Thailand who want to accept K-Bank QR payments on their POS system.
Overview
This guide explains how to register for K-Bank QR Payment, set up this payment option in your StoreHub BackOffice, and process K-Bank QR payments on your POS device. It also includes steps for manually approving QR payments if there's an issue.
This helps you offer more payment choices to your customers and manage your sales smoothly.
Before You Begin
A K-Bank business account.
Required documents for K-Bank registration (Consent Form, Identification Card, Company Registration).
Access to your StoreHub BackOffice.
A StoreHub POS device (e.g., iMin Falcon, Sunmi P2 Pro) powered on.
A stable internet connection for your POS device and BackOffice.
Step-by-Step Guide
Register for K-Bank QR Payment
1. To use KBank QR Payment, it is necessary to acquire a consent form from KBank, complete it, and provide your Identification card for authentication.
The necessary documents you’ll need are:
For Personal Registration:
K-Bank Consent Form
Your Identification Card
Company Registration documents
For Corporate Company Registration:
K-Bank Consent Form
Your Identification Card
Company Registration documents
2. Complete the K-Bank Consent Form and provide all necessary documents to K-Bank.
Notes:
K-Bank will start processing the documents within 1 business day of receiving them, by uploading them onto KBank's OneDrive. StoreHub will coordinate with KBank to ensure timely processing and facilitate QR code generation. This process includes verifying submitted documents and tracking the progress.
As a result of this process, the StoreHub Merchant ID will be generated.
1. K-Bank will review your documents. This process typically takes 7-14 business days. During this time, K-Bank may contact you for additional information. Please respond quickly to avoid delays.
2. Once approved, K-Bank will notify you via SMS and/or email. StoreHub will then generate your unique StoreHub Merchant ID for K-Bank QR payments.
Notes:
The speed of approval depends on how quickly you provide all required forms.
Monitor your email for configuration details or further steps after approval.
Set Up K-Bank QR Payment in StoreHub BackOffice
1. In your BackOffice, go to 'Settings', then tap 'Payment Options'.
2. Tap the '+ Add Payment Option' button.
3. In the 'Name' field, type a name for this payment option, for example, 'K-Bank QR'.
4. In the 'Type' field, select 'QR Code'.
5. In the 'QR Code Provider' field, select 'K-Bank'.
6. In the 'QR Code Type' field, select 'Dynamic QR Code'.
7. In the 'Stores' field, select the stores where you want to accept K-Bank QR payments.
8. In the 'Registers' field, select the specific POS registers within those stores that will use this payment option.
9. In the 'Merchant ID Number' field, enter your K-Bank Merchant ID Number (provided after K-Bank approval).
10. Tap 'Save' to complete the settings.
11. After saving, make sure to sync your POS register(s) to apply the new settings. On your POS device, go to 'Sync'.
Edit an Existing K-Bank QR Payment Option
1. In your BackOffice, go to 'Settings', then tap 'Payment Options'.
2. Find the 'K-Bank QR' payment option you want to edit and tap on the 'edit' button.
3. Make any necessary changes to the 'Name', 'Stores', 'Registers', or 'Merchant ID Number' fields.
4. Tap 'Save' to apply your changes.
5. Sync your POS register(s) to update the settings on your devices.
Delete an Existing K-Bank QR Payment Option
1. In your BackOffice, go to 'Settings', then tap 'Payment Options'.
2. Find the 'K-Bank QR' payment option you want to delete, and tap the 'Delete' button.
3. Confirm the deletion when prompted.
4. Sync your POS register(s) to remove the payment option from your devices.
Process a Payment with K-Bank QR Payment on Your POS
1. On your StoreHub POS device, after adding items to the cart, tap the 'Total Amount' button to go to the payment screen.
2. On the payment screen, select 'K-Bank QR' (or the name you saved in BackOffice) from the list of payment options.
3. A unique K-Bank QR code will appear on your POS device's main screen and/or customer-facing display for your customer to scan with their banking app.
4. Once the customer scans the QR code and completes the payment, the transaction will be marked as complete on your POS.
Notes:
K-Bank QR Payment supports 'QR Order & Pay - Pay at Counter'.
If a transaction is cancelled on the POS, a refund is automatically triggered to the customer's bank account for payments made with any mobile banking app supporting Thai QR Payment.
Troubleshooting
Issue | Solution |
QR Payment is stuck or not confirmed, but the customer says they paid. | Manually approve the QR payment.
1. If the QR payment doesn't confirm automatically, first verify with the customer that their payment was successful (e.g., by checking their banking app transaction history).
2. On your StoreHub POS device, while on the QR payment screen, tap the ellipses icon ('...') usually found at the top right or bottom of the screen.
3. Tap the 'Approve Manually' button that appears.
4. A pop-up box will ask you to confirm manual approval. Type a short note explaining why you are manually approving the payment (e.g., 'Customer showed bank confirmation').
5. Tap 'Confirm' to proceed. The transaction will now be marked as complete, and you can proceed to print or email the receipt.
6. You can find details of manually approved transactions in your BackOffice 'Offline Transactions' report. Look for the 'Reason for Manual Approval' note you entered. |
General K-Bank QR payment errors (e.g., connection issues, QR not generating). | 1. Clear device cache: On your StoreHub POS device (e.g., iMin Falcon), go to 'Settings', then 'Apps', find the 'StoreHub' app, and tap 'Clear Cache'.
2. Restart StoreHub app and check the internet: Close the StoreHub app completely and reopen it. Ensure your POS device has a stable internet connection (Wi-Fi or LAN).
3. Contact K-Bank Support: If issues persist, contact K-Bank directly to check the status of your merchant account or for any bank-side issues. |
FAQs
1. How long does K-Bank QR payment registration take?
After submitting all documents, K-Bank typically takes 7-14 business days to review and approve your application.
2. What documents do I need to register for K-Bank QR Payment?
You will need a K-Bank Consent Form, your Identification Card, and Company Registration documents. Requirements may vary slightly for personal vs. corporate registration.
3. Are there any fees for customers using K-Bank QR Payment?
Customers may potentially be charged extra fees depending on their bank's policy. This is outside of StoreHub's control.
4. What happens if I cancel a K-Bank QR transaction on the POS?
Cancelling a transaction on the POS automatically triggers a refund to the customer's bank account for payments made with any mobile banking app supporting Thai QR Payment.
5. Where can I find my StoreHub Merchant ID for K-Bank?
Your StoreHub Merchant ID will be generated after K-Bank approves your application and StoreHub completes the integration. You will be notified once it's ready.
Need Help?
Contact StoreHub Support via live chat in your StoreHub app or email [email protected].
Was this article helpful?
Let us know below or contact support for further assistance.