diff --git a/README.md b/README.md
index a249fb7..4191370 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,7 @@ Host it on your own server, define your workflow, install plugins and themes, an
- PipraPay Plugins & Integrations Directory
- Plugin Directory: [docs/Plugin-Directory.md](docs/Plugin-Directory.md)
- Browse all docs: [docs/](docs/)
+- API docs: [piprapay.readme.io](https://piprapay.readme.io)
---
@@ -91,6 +92,215 @@ We welcome contributions from the community. To contribute:
---
+## ❓ Common Issues & Solutions
+
+
+⏳ Pending payment is not auto-verifying
+
+**Possible Cause:**
+The cron job responsible for verifying payments is not running.
+
+**Solution:**
+1. Log in to the PipraPay **Admin Panel**.
+2. Navigate to **System Settings > Cron Job**.
+3. Copy the provided command.
+4. Set the cron job in your hosting control panel to run every **10 minutes**.
+
+
+
+---
+
+
+🔌 PipraPay tool app is not connecting
+
+**Possible Cause:**
+The base URL or webhook URL is not properly configured.
+
+**Solution:**
+1. First, add your **base URL** (e.g., `https://example.com` or `https://pay.example.com`).
+2. After setting the base URL, add the **full webhook URL**.
+
+
+
+---
+
+
+💳 No payment methods showing in the Admin Panel
+
+**Possible Cause:**
+The payment method plugins are not activated.
+
+**Solution:**
+1. Go to **Admin Panel > Plugin > Installed Plugins**.
+2. Activate the required **payment method plugins**.
+
+
+
+---
+
+
+🛒 Payment methods not showing on the checkout page
+
+**Possible Causes:**
+- Minimum and maximum payment amounts are not configured.
+- The payment method is disabled.
+
+**Solution:**
+1. Set the **minimum and maximum amount** for the payment method.
+2. Verify the **status**:
+ - If it is **disabled**, switch it to **enabled**.
+
+
+
+---
+
+
+💱 Currency mismatch (e.g., 1000 BDT showing as $1000 USD)
+
+**Possible Cause:**
+Currency exchange rates are not set correctly.
+
+**Solution:**
+1. In the **Admin Panel**, go to **System Settings > Currency Settings**.
+2. Update the currency rate.
+ - Example: `1 BDT = 0.0082 USD` (not `1 BDT = 1 USD`).
+
+
+
+---
+
+
+🔄 Website does not redirect after successful payment
+
+**Possible Cause:**
+Auto-redirect option is not enabled.
+
+**Solution:**
+1. Go to **Admin Panel > Appearance > Customize**.
+2. Enable the **Auto Redirect** option.
+
+
+
+---
+
+
+🔑 Forgot Admin Panel password
+
+**Solution:**
+1. Log in to your **hosting control panel**.
+2. Open the directory where **PipraPay files** are located.
+3. Edit the file `pp_config.php`.
+4. Change:
+ ```php
+ $password_reset = 'off';
+ ```
+ to
+ ```php
+ $password_reset = 'on';
+ ```
+5. Go to the **PipraPay Admin Login page** and click **Reset Password**.
+6. Set your new password.
+7. Re-edit `pp_config.php` and set:
+ ```php
+ $password_reset = 'off';
+ ```
+
+⚠️ **Important:** Always revert `$password_reset` to `'off'` after resetting for security reasons.
+
+
+
+---
+
+
+🌐 Payment API returning errors
+
+**Possible Cause:**
+Incorrect API credentials or endpoint configuration.
+
+**Solution:**
+1. Verify your **API key** and **secret** from the Admin Panel.
+2. Ensure the API endpoint matches your environment (**sandbox** vs **production**).
+3. Test using a REST client (e.g., Postman).
+
+
+
+---
+
+
+📦 Checkout page not loading properly
+
+**Possible Cause:**
+JavaScript conflicts or missing plugin files.
+
+**Solution:**
+1. Clear your **browser cache**.
+2. Recheck plugin installation in the Admin Panel.
+3. Disable conflicting plugins or themes temporarily.
+
+
+
+---
+
+
+🖥️ Hosting errors (500 Internal Server Error)
+
+**Possible Cause:**
+Server misconfiguration or insufficient resources.
+
+**Solution:**
+1. Check your server **error logs**.
+2. Increase **memory limit** and **max execution time** in PHP settings.
+3. Restart your web server (Apache/Nginx).
+
+
+
+---
+
+
+🔐 SSL certificate issues
+
+**Possible Cause:**
+Expired or misconfigured SSL certificate.
+
+**Solution:**
+1. Renew your SSL certificate with your hosting provider.
+2. Update the certificate path in your server configuration.
+3. Test the SSL status using online tools like **SSL Labs**.
+
+
+
+---
+
+
+📧 Customers not receiving email notifications
+
+**Possible Cause:**
+Email server or SMTP configuration is incorrect.
+
+**Solution:**
+1. Go to **Admin Panel > Plugins > Installed Plugin > SMTP Mailer Pro**.
+2. Go to **Admin Panel > Modules > SMTP Mailer Pro > Configure SMTP with valid credentials**.
+3. Test the email function using the built-in test tool.
+
+
+
+---
+
+
+⚙️ Database connection failed
+
+**Possible Cause:**
+Invalid database credentials or server downtime.
+
+**Solution:**
+1. Verify database credentials in `pp_config.php`.
+2. Check database server status.
+3. Ensure correct **host, port, username, and password** are set.
+
+
+
+---
+
## 🤷♂️ Community & Support
- Website: https://piprapay.com/