Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/lolosaisa/kazana-pay/archive/refs/heads/main.zip💸 Kazana Pay — Web3 Payments for Everyone
Kazana Pay lets any WordPress, shopify, wix merchant accept instant USDC payments on Base,
without writing a single line of blockchain code.
[CURRENTLY FOCUSING ON WORDPRESS]
It’s a lightweight plugin that adds a “Pay with Base” button to your checkout page.
Built for speed, trust, and reusability.
Overview
Merchant Setup Flow
- Install the Kazana Pay plugin.
- Connect your wallet via Base Account Kit or WalletConnect.
- Paste your USDC receiving address in plugin settings.
Customer Checkout Flow
- “Pay with Base” button appears on checkout.
- Buyer connects Base wallet.
- Pays in USDC (Base Testnet for demo).
- Base Pay SDK verifies transaction.
- Confirmation modal + optional NFT receipt.
🛠️ Tech Stack
| Layer | Tech / Library | Purpose |
|---|---|---|
| Frontend | JavaScript (ES6) | Handle button logic + Base Pay SDK |
| WordPress Core | PHP | Plugin logic, settings page |
| Blockchain | Base Pay SDK | Payment flow |
| Login | Base Account Kit | Wallet connection (optional) |
| NFT Minting | thirdweb SDK | Optional proof-of-purchase |
| Network | Base Sepolia (Testnet) | Demo transactions |
| Token | USDC Testnet | Payment currency |
Repository Structure
kazana-pay/ │ ├── kazana-pay.php # Main plugin file (entry point) ├── readme.txt # For WordPress directory (optional for now) ├── assets/ │ ├── js/ │ │ ├── kazana-pay.js # Frontend logic (Base Pay SDK, button UI) │ │ └── admin.js # For merchant dashboard interactions │ ├── css/ │ │ ├── style.css # Styles for button and modal │ │ └── admin.css # Styles for dashboard (if any) │ └── img/ │ └── logo.png # Plugin logo │ ├── includes/ │ ├── class-kazana-settings.php # Handles admin settings (wallet, USDC address) │ ├── class-kazana-checkout.php # Injects “Pay with Base” button on checkout │ └── class-kazana-api.php # For REST endpoints (when/ if needed) │ └── templates/ └── pay-button.php # HTML template for “Pay with Base” button
⚙️ Installation & Local Testing
1️Prepare a WordPress Dev Environment
You can use Local by Flywheel, XAMPP, or Laragon.
- Download & install WordPress locally.
- Log in to
http://localhost/wp-admin. - Navigate to wp-content/plugins/. Find plugin and activate.
- Copy your plugin folder here:
/wp-content/plugins/kazana-pay/
2️ Activate the Plugin
- In the WordPress Admin Panel → Plugins → Installed Plugins
- Find Kazana Pay and click Activate
You should now see:
- “Kazana Pay” settings under Settings → Kazana Pay
- A “Pay with Base” button on any checkout page where you call the template.
🧪 Testing Payments on Base Testnet
- Get Base Sepolia USDC tokens from faucet (search Base USDC Faucet).
- Open your site → checkout → click Pay with Base.
- Connect wallet → confirm transaction → you’ll see a success alert.
- Check transaction on Base Sepolia Explorer.