PipraPay - Payment Automation Platform

PipraPay is a self-hosted payment automation platform by QubePlug Bangladesh. Host it on your own server, define your workflow, install plugins and themes, and stay in control. It’s free to use with no monthly fees. Visit https://piprapay.com/ for more info.

---

Table of Contents

• Documentation
• Features
• Installation
• License & Brand Protection
• Trademark Policy
• Contributing
• Community & Support

---

📖 Documentation

• Developer guides live in docs/:

  • Payment Gateway Plugins: docs/Payment-Gateway-Plugins-Developer-Guide.md
  • Module Plugins: docs/PipraPay-Module-Plugin-Developer-Guide.md

• PipraPay Plugins & Integrations Directory

  • Plugin Directory: docs/Plugin-Directory.md

• Browse all docs: docs/

• API docs: piprapay.readme.io

---

🚀 Features

• Self-hosted: deploy on your own server with no third‑party lock‑in.
• Plugin-based architecture for gateways, modules, and tools.
• Theme support for admin dashboard branding.
• Multiple gateways (Stripe, bKash, Nagad, etc.) via plugins.
• Automatic transaction verification to reduce manual work.
• Scales to unlimited transactions (within your server capacity).
• Integrations with platforms like WooCommerce, WHMCS, and WordPress.

---

⚙️ Installation

1. Clone this repository:

   git clone https://github.com/PipraPay/PipraPay-Open-Source-Web.git
   

2. Prepare your environment: PHP, a database, and a web server (Apache/Nginx).
3. Upload or place the source files on your server.
4. Install dependencies (if any) as per your setup.
5. Configure database credentials, domain, and environment settings.
6. Access the admin panel, install plugins, and configure gateways.

---

📚 License & Brand Protection

• Code is licensed under the GNU Affero General Public License v3.0 (AGPL‑3.0). See LICENSE.

---

🛡️ Trademark Policy

The PipraPay name, logo, and brand identity are trademarks of QubePlug Bangladesh.

✅ What you can do

• Use PipraPay as provided, including branding.
• Build and share plugins, modules, and themes.
• Contribute back to this repository.

❌ What you cannot do

• Rebrand the system (e.g., rename it to another product).
• Remove or replace the PipraPay name/logo/brand in a modified version and present it as your own brand.

---

🤝 Contributing

We welcome contributions from the community. To contribute:

1. Fork this repository.
2. Create a new branch:

   git checkout -b feature/your-feature-name
   

3. Make your changes.
4. Commit with a clear message.
5. Push to your fork and open a Pull Request describing your changes.

---

❓ 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:

   $password_reset = 'off';
   

   to

   $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:

   $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/
• Documentation: docs/
• License: LICENSE
• Issues & bug reports: https://github.com/PipraPay/PipraPay-Open-Source-Web/issues