Skip to content

Latest commit

 

History

History
102 lines (65 loc) · 2.95 KB

README.md

File metadata and controls

102 lines (65 loc) · 2.95 KB
Raw

PHP PayPal Gateway - Simple Payment System

Welcome to the PHP PayPal Gateway! This project is a lightweight payment system using PayPal Smart Buttons, built with PHP (OOP), JavaScript (AJAX), and a basic MVC structure. The system allows users to create orders, process payments, and handle errors seamlessly.

📜 Features

  • Order Creation: Collect user data through a form and validate it with AJAX before creating an order.
  • PayPal Integration: Includes PayPal Smart Buttons for payment via PayPal account or credit/debit card.
  • Error Handling: Returns JSON responses for validation errors or payment issues.
  • Environment Configuration: Stores sensitive data (like PayPal credentials) securely in a .env file.
  • Customizable: Free to modify and extend as needed.

📦 Requirements

Before using the project, ensure the following tools are installed:

  • PHP >= 8.2.12
  • Apache Web Server (with .htaccess enabled)
  • Composer (for managing dependencies)

🚀 Installation

Clone the Repository

git clone https://github.com/johnvegagit/php-paypal-gateway.git

Install Dependencies

Use Composer to install the required packages:

composer require vlucas/phpdotenv

⚙️ Environment Configuration

Create a .env file in the root directory and configure the following variables:

BASEURL="http://localhost/public_html/php-paypal-gateway/"
BASEPTH="/opt/lampp/htdocs/public_html/php-paypal-gateway/"

DBHOST="localhost"
DBNAME="dbname"
DBUSER="root"
DBPASS="yourpassword"

CLIENTID="your-paypal-client-id"
SECRETKEY="your-paypal-secret-key"

🔧 Usage

  1. Place the project in your Apache root directory (e.g., /opt/lampp/htdocs).
  2. Access the checkout page:
    • Navigate to http://localhost/public_html/php-paypal-gateway/checkout.
    • Fill out the form and submit to create an order. Errors are handled via JSON responses.
  3. Complete payment:
    • Redirects to http://localhost/public_html/php-paypal-gateway/checkout/payment?token=1234.
    • Use PayPal Smart Buttons to complete payment via PayPal or credit/debit card.
  4. Payment result:
    • Successful payments redirect to a success page.
    • Failed payments redirect to an error page with detailed messages.

📈 Future Improvements

This is the first version of the system. Planned updates include:

  • Remove the product from the cart after payment is completed.
  • Cancel the order and change its status from 'Pending' to 'Cancelled'.

Feel free to contribute or fork the project to make it better!

🤝 License & Disclaimer

This project is free to use and modify. You can:

  • Use it in personal or commercial projects.
  • Fork and extend it as needed.

Disclaimer: Use this project at your own risk. It is provided "as is" with no guarantees.

Happy coding! 🚀 If you encounter any issues or have suggestions, feel free to open an issue on the repository.