1QR

Help Center

Troubleshooting

Fixes for the WooCommerce connector, 1QR Android app, dashboard, checkout, and license.

Bangla QR does not appear at checkout
  • Confirm WooCommerce is active, then go to WooCommerce → Settings → Payments.
  • Open 1QR Cloud Connector for WooCommerce, tick Enable Bangla QR Payment, and click Save changes.
  • Activate a valid license key. Checkout stays off until the license is active.
  • Deactivate any old 1QR / 1QRBD payment plugin. Only the Cloud Connector should run.
Plugin will not activate, or WordPress shows a conflict
  • The ZIP must contain a top-level folder named 1qrbd-cloud-connector.
  • Delete leftover renamed copies under wp-content/plugins and keep only Cloud Connector.
  • Requires PHP 7.4+ and WooCommerce 7.0+.
License will not activate, or checkout says the license is invalid
  • Paste the key from your 1qrbd.com order, then click Activate (not only Save).
  • Use the key on the same site URL you licensed. Changing domain usually needs a deactivate, then activate again.
  • If the banner says the license token expired, click Deactivate License, then Activate again.
Popup branding, logo, or theme did not save
  • Brand / shop name allows English letters and numbers only (A–Z, 0–9).
  • Click Save changes at the bottom of the gateway screen after every edit.
  • QR image, SMS senders, and devices are not on this WooCommerce screen — they live on dash.1qrbd.com.
WordPress does not show a plugin update
  • Installed shops check 1qrbd.com → Settings → 1QRBD Releases, not the Resources ZIP alone.
  • The published version must be higher than the version in 1qrbd-cloud-connector.php.
  • On the shop, go to Dashboard → Updates → Check again. WordPress only polls a few times per day.
Cannot install the APK / Play Protect blocks it
  • Allow Install unknown apps for your browser or Files app.
  • If Play Protect warns, choose Install anyway. You can turn Play Protect back on after install.
  • Download only from the official 1QR APK.
Status: Disconnected, or cloud key rejected
  • Phone needs internet. Open Setting and paste a fresh key from Dashboard → Devices.
  • The key is shown once when created. If you lost it, create a new connection key and save it in the app.
  • Revoking a key on Devices stops that phone only.
SMS stays Error, or never becomes Used
  • Grant SMS and notification permission. Open Senders and turn ON the payment sender.
  • Sender must match the SMS ID on the phone (for example TallyPay, bKash, 16216 for Rocket) and the same name on Dashboard → Providers.
  • Sent means Cloud received it. Used means it was consumed for an order. Tap Sync on Home if Used is delayed.
  • Error includes failed sends and SMS Cloud ignored (wrong sender or format).
Forwarding works for a while, then stops
  • Set battery usage for 1QR to Unrestricted / no optimization.
  • Allow Auto-start, background activity, and background mobile data.
  • Lock/pin 1QR in Recents. Avoid Battery Saver while waiting for payment SMS.
  • On OPPO / Realme / Xiaomi / vivo / Samsung / Huawei / OnePlus, add 1QR to Protected / Never sleeping apps.
No in-app “Update available” dialog
  • The app checks about once every 24 hours, and only when online.
  • Update JSON must have a versionCode higher than the installed app. versionName is display only.
  • Until that JSON is published, install the new APK from the Resources page.
Cannot log in to the dashboard
  • Sign in at dash.1qrbd.com with the email that received the set-password message after license activate.
  • Check spam for the set-password mail. Use the link, then create a password. Dashboard login is not your WordPress admin password.
  • You can also open Dashboard home from the WooCommerce gateway settings.
Checkout shows no QR, or an old QR
  • Dashboard → QR & SMS → Bangla QR Images. Upload a clean, uncropped image (JPEG/PNG/GIF/WebP, 2 MB or smaller).
  • Open the image, choose a Bangla QR Provider, then click Set Live. Checkout uses the live image only.
  • If the flash says the live QR has no provider, Edit it, pick a provider, and Set Live again.
SMS format / provider mismatch
  • Open Providers. TallyPay and bKash templates are added for you — edit them if your SMS wording is different.
  • Provider Name must match the sender on the phone. Special characters (for example a trailing dot) must be typed exactly.
  • Each format line needs amount, payer number, and datetime tokens, for example {amount="Tk"} from {number} {datetime="dd/MM/yyyy HH:mm"}.
Need a new phone / lost the cloud key
  • Dashboard → Devices → create a connection key → copy it immediately. It is not shown again.
  • Paste it in the Android app Setting tab as Cloud key.
  • Lost a handset? Revoke that key. Other phones keep working.
Customer paid, but the order did not update
  • The paid amount must match the amount shown on the popup QR (including any extra paisa used to keep orders unique).
  • Pay within the checkout window (a few minutes). An expired popup needs a new checkout.
  • On the phone, confirm the SMS is Sent then Used. If it is Error, fix sender/provider first.
  • As a backup, the buyer can tap Submit your mobile number in the popup. That places the order On Hold for you to confirm.
Order went On Hold instead of Processing / Completed
  • That is expected for semi-automatic (mobile number) confirmation until you review the payment.
  • Automatic SMS match uses Payment Complete Status for physical products and Payment Complete Status (Digital Product) when the order is digital only.
QR will not scan, or the wallet shows the wrong shop name
  • Re-upload a sharp, uncropped Bangla QR from your bank or MFS, then Set Live.
  • Shop name on scan uses the gateway Brand Name setting (English letters and numbers) and the “Show Name on QR Scan” toggle.
Popup opens on payment options instead of the QR
  • Enable Direct QR checkout in WooCommerce gateway settings if you want the QR immediately.
  • Uncheck it only if you want buyers to pick a method first.
Several orders with the same amount are open together
  • 1QR assigns a unique amount (Tk 0.01 steps) so each pending QR can be matched. The buyer must pay the exact figure on their screen.
  • If the pool is full, wait for older checkouts to finish or expire, or raise Smart Verification Pool Size in gateway settings.
No set-password email after activating the license
  • Check spam and the inbox of the email on the 1qrbd.com license, not a different shop admin email.
  • Activate from the Cloud Connector license field. The dashboard account is created on a successful activate.
Forgot dashboard password
  • Use forgot-password on dash.1qrbd.com. It does not create a new account.
  • If you never set a password, use the original set-password email instead.
Resources ZIP / APK download fails
  • Use the Resources page links. Direct files:
  • Plugin ZIP
  • Android APK
  • If a browser cached an old file, try a private window or add ?v=2 once after we publish a new file.
Verification quota or license window message in WooCommerce
  • Some licenses show a rolling verification count on the gateway screen. If you hit the cap, wait for the window to roll or upgrade the plan on 1qrbd.com.
  • Checkout also needs a fresh license token. Deactivate and Activate if the reconnect warning stays.