UPI SmartPay for WooCommerce

Smart UPI QR payment gateway for WooCommerce — accept UPI payments without third-party fees or API keys.

Developed by IAMPMPKSAMY 🌐 Plugin page: Plugins Hub

Overview

UPI SmartPay eliminates the need for a payment aggregator for UPI collections. Customers pay via QR code or UPI ID, confirm with a UTR number, and optionally upload a screenshot. Store admins verify and approve with one click — no third-party fees, no API keys.

Features

Requirements

• WordPress 5.8+
• WooCommerce 6.0+
• PHP 7.4+

Installation

Via WordPress Admin

Plugins → Add New → Search "UPI SmartPay" → Install → Activate
WooCommerce → Settings → Payments → UPI SmartPay → Manage

Manual

cd wp-content/plugins/
git clone https://github.com/iampmpksamy/WordPress_UPI_SmartPay_For_WooCommerce.git upi-smartpay

Activate from Plugins → Installed Plugins, then configure.

See the complete installation guide or the project wiki before enabling the gateway on a production store.

Configuration

File Structure

upi-smartpay/
├── pmpk-upi-smartpay.php            # Bootstrap singleton (Plugin Name header here)
├── includes/
│   ├── class-pmpk-gateway.php       # PMPKSAMY_UPI_Gateway (WC_Payment_Gateway)
│   ├── class-pmpk-ajax.php          # PMPKSAMY_UPI_Ajax — all AJAX endpoints
│   ├── class-pmpk-qr-generator.php  # PMPKSAMY_QR_Generator
│   └── class-pmpk-helper.php        # PMPKSAMY_Helper — static utilities
├── admin/
│   └── class-pmpk-admin.php         # PMPKSAMY_UPI_Admin — order UI
├── public/
│   ├── class-pmpk-public.php        # PMPKSAMY_UPI_Public — asset loader
│   ├── templates/
│   │   └── thankyou.php             # Payment panel template
│   ├── branding-page.html           # Plugin landing page
│   └── portfolio.html               # Developer portfolio page
├── assets/
│   ├── js/
│   │   ├── pmpk-frontend.js         # Copy, upload, confirm, polling
│   │   └── pmpk-admin.js            # Approve/Reject AJAX
│   ├── css/
│   │   ├── pmpk-frontend.css        # Mobile-first payment panel
│   │   └── pmpk-admin.css           # Admin badges, meta box, branding
│   └── images/
│       └── upi-logo.svg             # Checkout icon
├── languages/
│   └── upi-smartpay.pot             # Translation template
├── .github/workflows/
│   └── release.yml                  # CI: lint → PHPCS → ZIP → GitHub Release
├── readme.txt                       # WordPress.org readme
└── README.md                        # This file

Order Flow

Customer checkout
       │
       ▼
Order: On Hold  ·  _pmpksamy_payment_status = pending
       │
       ▼  Customer pays + clicks "I Have Paid"
       │
       ▼
Order: On Hold  ·  _pmpksamy_payment_status = confirmed
       │             Admin email sent
       │
       ├── Admin Approves → payment_complete()  → Processing
       │                     status = approved
       │
       └── Admin Rejects  → Status: Cancelled
                             status = rejected

Developer Filters

Example: self-hosted QR service

add_filter( 'pmpksamy_qr_image_url', function( $url, $data, $size ) {
    return 'https://your-qr-server.com/qr?data=' . rawurlencode( $data ) . '&size=' . $size;
}, 10, 3 );

Screenshots

Contributing

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/your-feature.
3. Follow WordPress Coding Standards.
4. Open a pull request against main.

Security

Found a vulnerability? Email security@pmpksamy.com before public disclosure. Response within 48 hours.

For normal support, use GitHub Issues and follow the support guide. Do not post UPI IDs, payment screenshots, customer details, credentials, or production logs containing personal information.

Changelog

1.0.3

• Initial public release.

License

GPL-2.0-or-later

Developed by IAMPMPKSAMY  ·  Plugins Hub