WC InstaPay – WooCommerce Payment Gateway

Accept InstaPay payments in your WooCommerce store with a seamless, modern checkout experience.

Features • Installation • Configuration • How It Works • File Structure

Features

💳 Customer Experience

• Beautiful Payment Page — Premium dark-themed UI with QR code, copy-to-clipboard IPA address, and real-time countdown timer
• WooCommerce Blocks Support — Full compatibility with the new WooCommerce Checkout Block editor
• Live Payment Polling — Automatic page updates when admin confirms payment (no manual refresh needed)
• Responsive Design — Optimized for desktop, tablet, and mobile screens

🛠️ Admin Dashboard

• One-Click Verification — Confirm or reject InstaPay payments directly from the orders list
• SweetAlert2 Modals — Elegant, compact confirmation dialogs
• Admin Bar Notifications — Pulsing badge showing pending InstaPay orders count
• Custom Order Status — Dedicated Awaiting InstaPay status with branded label and tooltip
• InstaPay Action Column — Shows only for InstaPay orders, keeping your orders list clean

🔒 Security

• AJAX nonce verification on all endpoints
• Order key validation for polling requests
• WordPress capability checks for admin actions

Installation

1. Download or clone this repository:

   git clone https://github.com/0xEmz/wc-instapay.git

2. Copy the wc-instapay folder to your WordPress plugins directory:

   wp-content/plugins/wc-instapay/

3. Activate the plugin from WordPress Admin → Plugins

4. Configure the gateway at WooCommerce → Settings → Payments → InstaPay

Requirements

• WordPress 5.8+
• WooCommerce 7.0+
• PHP 7.4+

Configuration

Navigate to WooCommerce → Settings → Payments → InstaPay and configure:

How It Works

Payment Flow

Customer                          Admin
   │                                │
   ├─ Selects InstaPay at ─────►   │
   │  checkout                      │
   │                                │
   ├─ Sees payment page with ──►   │
   │  QR code + IPA address         │
   │                                │
   ├─ Sends InstaPay transfer ──►  │
   │                                │
   ├─ Clicks "I've paid" ──────►   │
   │                                │
   ├─ Sees "Payment Under ─────►  │
   │   Review" waiting screen       │
   │                                ├─ Gets notification
   │                                │  (admin bar badge)
   │                                │
   │                                ├─ Clicks ✓ to verify
   │                                │  payment
   │                                │
   │  ◄──── Auto-redirected to ────┤
   │        Thank You page          │
   └────────────────────────────────┘

Order Statuses

File Structure

wc-instapay/
├── wc-instapay.php                          # Main plugin file & bootstrap
├── assets/
│   ├── css/
│   │   └── payment-page.css                 # Payment page styles (dark theme)
│   ├── js/
│   │   ├── instapay-block.js                # WooCommerce Blocks integration
│   │   └── upload.js                        # (Legacy) receipt upload handler
│   └── instapay-logo.png                    # InstaPay brand logo
├── includes/
│   ├── class-wc-gateway-instapay.php        # Gateway class (settings, processing)
│   ├── admin/
│   │   ├── class-wc-instapay-admin.php      # Admin settings page
│   │   ├── class-wc-instapay-admin-bar.php  # Admin bar notification badge
│   │   └── class-wc-instapay-order-status.php # Custom status, actions column
│   ├── blocks/
│   │   └── class-wc-instapay-blocks.php     # WooCommerce Block checkout support
│   ├── emails/
│   │   └── class-wc-instapay-emails.php     # Email notifications
│   ├── frontend/
│   │   ├── class-wc-instapay-checkout.php   # Thank you page customization
│   │   └── class-wc-instapay-payment-page.php # Payment & review screens
│   └── upload/
│       └── class-wc-instapay-upload.php     # (Legacy) receipt upload handler
└── .gitignore

Tech Stack

• PHP — WordPress plugin architecture with OOP patterns
• JavaScript — Vanilla JS for AJAX polling, clipboard, timer
• CSS — Custom dark theme with glassmorphism, gradients, animations
• WooCommerce API — Payment gateway, order statuses, blocks integration
• SweetAlert2 — Admin confirmation modals (loaded from CDN)
• Lucide Icons — Modern icon set (loaded from CDN)

Screenshots

Payment Page

Premium dark-themed payment interface with QR code and IPA address.

Payment Under Review

Live waiting screen with order progress steps and automatic polling.

Admin Orders List

One-click payment verification with SweetAlert2 confirmation modals.

Changelog

v1.0.0 (2026-04-07)

• 🎉 Initial release
• ✅ InstaPay payment gateway with QR code + IPA copy
• ✅ Custom Awaiting InstaPay order status
• ✅ Admin bar notification badge
• ✅ One-click payment verification from orders list
• ✅ Live payment polling with auto-redirect
• ✅ WooCommerce Blocks checkout support
• ✅ SweetAlert2 admin modals
• ✅ Responsive dark-themed UI

License

This plugin is proprietary software. All rights reserved.

Built with ❤️ for the Egyptian e-commerce community