1QR - Bangla QR payment plugin Configuration Guide
Set up 1QR on your WooCommerce store in just a few simple steps. Whether you use Manual Verification (Free) or Automatic Verification (Pro), this guide will walk you through everything you need.
Pre-Requisites
Before You Start
Before configuring the plugin, make sure you have the following requirements ready:
For Core Setup (Free / Pro)
- WordPress with WooCommerce installed
- Your Bangla QR image provided by your Bank or MFS
- 1QR plugin installed & active
For Automatic Verification PRO
- An Android phone that receives payment SMS
- SMS Gateway (SMS Gate) app installed
Install & Activate 1QR Plugin
Upload the downloaded ZIP file from your WordPress dashboard seamlessly.
After activation, navigate to the unified WooCommerce payments tab:
Find 1QR – Bangla QR Payment and click Manage to open the main configuration console.
Enable Payment Gateway
Simply toggle and enable the payment gateway engine within the interface to make it live during checkout iterations.
Always remember to click Save changes at the bottom of the gateway node.
Upload Your Bangla QR
Upload the standard Bangla QR image you received from your Bank or Mobile Financial Service (MFS).
Pro Tip: Use a clean, uncropped, high-quality QR image.
Customize Your Checkout UI
Personalize the customer-facing payment gateway popup canvas by configuring your brand parameters:
- Payment Method Title: Change how the text looks on checkout payment selection list.
- Description: Clear custom instructions for consumers.
- Store Details: Input custom Store Name and upload a crisp Store Logo to build premium consumer trust inside the popup template.
- Popup Theme: Select a popup theme.
Choose Verification Method
1QR supports two distinct validation methodologies tailored to your business operations scale.
Customers complete the payment by scanning the QR code and then enter the last 4 digits of their payment mobile number. The order is placed On Hold, and site admin manually verify the payment from payment transaction SMS or transaction history before processing the order.
After payment, the Mobile Companion App securely sends the payment SMS directly to your website via a signed webhook. 1QR instantly verifies the payment and updates the order status automatically. Your payment SMS is sent directly to your website. 1QR never stores or processes your merchant SMS on our servers.
Select Your Bangla QR Provider
Map the precise structural layout template matching your core payment aggregator endpoint provider inside the setting panel fields (e.g., bKash, TallyPay, or Custom Parser parameters).
Correct parsing mappings guarantee regular string matches on inbound incoming dynamic transaction text nodes.
Configure Automated Order Status
Determine the processing funnel automation path target for successful verified payment cycles:
Note: Manual Payment verification modes always defaults order routing paths to the safe On Hold state until admin review actions occur.
Place a Live Test Order
Before launching marketing frameworks, confirm standard operational statuses run fine:
- Add mock item to cart and select 1QR Gateway option during checkout.
- Scan the injected canvas modal using your separate consumer wallet application.
- Complete checkout and verify hook status response modifications reflect properly on your order table dashboard.
You're Ready to Scale!
Congratulations! Your automated digital asset node is now running. Your WooCommerce storefront is instantly configured to process next-gen Bangla QR payments native checkouts.
Install Mobile Companion App (SMS Gateway)
Automatic Verification requires a dedicated active Android handset that receives your business node merchant payment SMS alerts.
⚠️ Play Store Permission for Third-Party Installation
Since this app is installed directly from an APK link (outside the Google Play Store), Google Play Protect may flag it during installation. Follow these steps to bypass it safely:
- Open the Google Play Store app on your Android device.
- Tap your Profile Icon in the top-right corner.
- Select Play Protect from the menu, then tap the Settings (Gear) Icon in the top right.
- Turn OFF the toggle for "Scan apps with Play Protect".
- Now proceed to install the downloaded APK file. Once installed successfully, you can turn Play Protect back ON if you wish.
Crucial Android Background Optimization Rules
To route real-time verification triggers, Android must never force-sleep or throttle the companion app runtime. You must configure the system rules explicitly below:
- Disable Battery Optimization: Switch to 'Unrestricted' or 'No Optimization' state.
- Allow Auto Start: Permit the service to re-initiate automatically on system reboot loops.
- Lock App in Recents: Open your app switcher dashboard and lock/pin the app window down.
- Allow Background Mobile Data: Ensure unchecked network loops are active.
Configure SMS Companion App Settings
Open the SMS Gateway app on your Android device and carefully configure the parameters listed below inside each tab:
- Set Cloud server → ON
- Set Start on boot → ON
- Tap the "ONLINE" button to initiate the background listener.
- Click on "Cloud Server" → From here, copy the auto-generated Username and Password (Note: Users can enter their own custom password here if preferred).
- Go back to the main Settings page.
- Click on "Webhooks" → Then click "Signing Key" → Type a random secure key phrase (e.g.,
Dxodke9Kd55d11d). *The recommended length is 10–16 characters.* Click OK to save.
Connect Gateway to WooCommerce Instance
Now, head back to your WordPress administrator backend to map the active credentials:
Paste the retrieved Username, Password, and custom Signing Key directly into the relative input parameters and hit Connect Terminal.