# QR Pay for WooCommerce

Accept **QR-based manual wallet payments** in WooCommerce using personal accounts.  
Supports **25+ global wallet providers** including bKash, Nagad, Rocket, Upay, Paytm, PhonePe, GCash, M-Pesa, Apple Pay, Google Pay, Stripe, PayPal, Wise, Klarna, Afterpay, and more.

Customers scan your QR code, pay in their wallet app, and submit the **Transaction ID** for manual verification.

[![WordPress](https://img.shields.io/badge/WordPress-6.8-blue?logo=wordpress)](https://wordpress.org/)  
[![WooCommerce](https://img.shields.io/badge/WooCommerce-10.1%2B-96588A?logo=woocommerce)](https://woocommerce.com/)  
[![PHP](https://img.shields.io/badge/PHP-7.4%2B-777BB4?logo=php)]()  
[![License: GPL v2](https://img.shields.io/badge/License-GPLv2%2B-green.svg)](https://www.gnu.org/licenses/gpl-2.0.html)

---

## 🌍 Supported Payment Providers (25+)

### 🇧🇩 Bangladesh
- bKash  
- Nagad  
- Rocket  
- Upay  
- SureCash  
- MCash  
- NexusPay  

### 🇮🇳 India
- Paytm  
- PhonePe  
- Google Pay (India)  
- Amazon Pay  
- Stripe UPI  
- PayPal (QR-supported regions)  

### 🇵🇰 Pakistan
- Easypaisa  
- JazzCash  

### 🇵🇭 Philippines
- GCash  
- Maya (PayMaya)  

### 🇰🇪 Kenya
- M-Pesa  

### 🌐 Global Providers
- Apple Pay  
- Google Pay  
- Payoneer  
- Afterpay  
- Klarna  
- Wise  
- Stripe (QR-supported countries)  
- Alipay  

Each provider appears as its own WooCommerce gateway.

---

## ✨ Key Features

### ✔ 25+ Personal-Account QR Wallet Gateways
Each gateway includes:
- Custom title & description  
- Uploadable QR code image  
- Account number field  
- Transaction ID & payer last-4-digits inputs  
- Smart checkout UI  
- Manual verification workflow  

---

### ✔ Manual Verification (No API Required)
Perfect for:
- Stores without merchant accounts  
- Personal wallet payments  
- Markets where QR is widely used  

---

### ✔ Processing Fee System
Add a percentage-based fee to:
- Cart  
- Checkout  
- Order totals  
With tax support.

---

### ✔ Smart Checkout Experience
- Clean, responsive QR payment box  
- Wallet info & final amount  
- Instructions & payment steps  
- Custom input fields  

---

### ✔ Order Meta Stored Automatically
Appears on:
- Thank You page  
- Customer emails  
- WooCommerce admin (Order Details)  

---

### ✔ Secure & Optimized
- Sanitized user input  
- Escaped output  
- Nonce verification handled by WooCommerce  
- No external API calls  
- Fast performance  

---

### ✔ Developer-Friendly (OOP)
- Abstract gateway class  
- Extendable structure for new providers  
- Hooks for customization

---

## 📦 Installation

1. Upload the plugin to `/wp-content/plugins/all-qr-pay-for-woocommerce/`
2. Activate via **Plugins → Add New**
3. Go to **WooCommerce → Settings → Payments**
4. Enable any provider (bKash, GCash, Paytm, PhonePe, M-Pesa, etc.)
5. Upload QR image and enter wallet account number
6. Customers will see the QR payment box at checkout

---

## ❓ FAQ

### **Does this plugin verify payments automatically?**
No. Admin manually checks the Transaction ID in the wallet app.

### **Do I need a merchant account?**
No — personal accounts are supported.

### **Are API keys required?**
No API calls or credentials are stored.

### **Can developers add new providers?**
Yes. The plugin is fully extendable.

---

## 🖼 Screenshots

1. Checkout QR payment box  
2. Order details payment metadata  
3. Email payment details  
4. Payment settings (QR upload + account number)  

---

## 📝 Changelog

### **1.0.0**
- Added 25+ wallet gateways:
  bKash, Nagad, Rocket, Upay, MCash, NexusPay, SureCash,  
  Paytm, PhonePe, GCash, JazzCash, Easypaisa, Maya,  
  M-Pesa, PayPal, Stripe, Apple Pay, Google Pay,  
  Payoneer, Afterpay, Klarna, Wise, Amazon Pay, Alipay.
- QR upload + account number  
- Transaction ID + payer last 4 digits  
- Checkout + email + admin order integration  
- Processing fee with tax  
- Full sanitization & escaping  
- OOP architecture for extensibility  

---

## ⚖️ License

Licensed under **GPL v2 or later**  
https://www.gnu.org/licenses/gpl-2.0.html

---

### Trademark Disclaimer
This plugin is not affiliated with WooCommerce or any listed payment provider.  
All trademarks belong to their respective owners.

---

## 👨‍💻 Author

**Md Abul Bashar**  
🌐 https://hmbashar.com  
📧 contact@hmbashar.com  
🔗 https://facebook.com/hmbashar