🚀 Overview

PayPal PRO Payment Terminal is a professional PHP gateway module that lets you accept
direct credit/debit cards via PayPal Payments Pro / Payflow Pro, alongside PayPal Express Checkout,
one-time payments, and recurring subscriptions. It’s built for real-world scenarios—SaaS billing, invoice links, donation pages,
and order checkouts—where reliability, auditability, and clear error handling matter.

Target users: SaaS owners, digital agencies, freelancers, membership sites, and small–mid businesses that need a
drop-in terminal for PayPal Pro with clean code and fast setup.

✨ Key Features

• PayPal Payments Pro / Payflow Pro: Direct card charges on your site (US/UK/CA availability—subject to PayPal region policies).
• Express Checkout: Offer PayPal wallet alongside cards for higher conversion and buyer protection.
• Subscriptions & Billing Plans: Create recurring profiles (monthly/annual), trials, proration options, and dunning emails.
• Refunds, Voids & Captures: Full/partial refunds from the dashboard; authorize-then-capture flows for delayed fulfillment.
• Invoices & Quick Pay Links: Generate secure payment links or embeddable buttons for invoices and quotes.
• Webhooks/IPN Support: Sync payment status (paid, failed, refunded, disputed) and update orders automatically.
• Tax & Currency: Multi-currency support with configurable VAT/GST rates and line-item taxes.
• Receipts & Email Notices: Branded receipts, success/failure notifications, and downloadable PDFs.
• Logs & Reporting: Transaction logs, settlement summaries, exports (CSV) for accounting.
• Security & Compliance Aids: HTTPS enforcement, tokenized storage (no raw PAN), CSRF protection, and rate-limit guards.

⚙️ Technical Stack

• Language/Runtime: PHP 8.0+ (7.4 compatible), Composer, cURL, OpenSSL, JSON.
• Framework: Vanilla PHP with service classes; optional integration stubs for Laravel 9/10.
• APIs Supported: PayPal Classic (NVP/SOAP) for Payments Pro / Payflow Pro and PayPal Express;
  REST webhook verifier utility included.
• Database: MySQL/MariaDB for orders, customers, subscriptions, logs.
• Server: Linux hosting with Apache/Nginx, HTTPS (TLS 1.2+), PHP extensions (pdo, pdo_mysql, curl, mbstring, openssl, json).
• Browser/Admin: Latest Chrome, Edge, Firefox, Safari.

Experience tip: For card fields rendered on your domain, review PayPal’s compliance guidance; depending on setup you may
fall under stricter PCI-DSS scope. Prefer hosted fields where possible.

🧩 Installation Guide

1. Upload: Copy files to your web root (e.g., /var/www/paypal-terminal).
2. Dependencies: Run composer install --no-dev --optimize-autoloader.
3. Environment: Duplicate .env.example → .env; set DB_*,
   APP_URL, and PayPal credentials (API_USERNAME, API_PASSWORD,
   API_SIGNATURE or Payflow keys).
4. Database: Run migrations or import schema.sql; create an admin user.
5. Webhooks/IPN: In your PayPal dashboard, configure IPN/Webhook URL
   https://yourdomain.com/webhooks/paypal and enable the desired events.
6. Mode: Switch PAYPAL_MODE to sandbox for testing; run test payments, refunds, and subscription sign-ups.
7. Harden: Enforce HTTPS, rotate API keys, lock down the admin route by IP (optional), set file permissions.

📦 Deliverables

• Full PHP source code (controllers/services/views) under GPL.
• .env.example and config files for credentials and modes.
• SQL schema / migrations for orders, subscriptions, logs, and invoices.
• Webhook/IPN handler with signature validation helpers.
• Minimal admin UI (transactions, refunds, payouts, reports).
• Integration snippets for Laravel (routes, config, service provider).
• Documentation (setup, sandbox tests, go-live checklist).

📱 Supported Platforms

• Linux shared/VPS/cloud hosting with PHP & MySQL.
• cPanel/Plesk/DirectAdmin environments.
• Any CMS/app that can post to the terminal (WordPress, Laravel, plain PHP).

🧠 Notes

• License: Distributed under the GPL. You can study, modify, and redistribute the code under GPL terms.
• Compliance: Use HTTPS, avoid handling raw PAN data, prefer hosted fields; consult your acquirer on PCI obligations.
• Customization Tips: Add coupons/taxes, multi-tenant mode, webhook retries, dispute webhooks, and accounting exports.
• SEO Assurance: Structured headings and keywords (PayPal Pro gateway, Payflow Pro, PHP payment terminal, subscriptions) are included for better discoverability.

👨‍💻 Original Developer Credit

Credit to the original commercial author of the “PayPal PRO Payment Terminal” script.
For official vendor support or a commercial license, please refer to the original marketplace listing
(e.g., CodeCanyon).

🔒 Disclaimer

This release is a GPL redistribution for educational and development use. It is not affiliated with or endorsed by PayPal.
“PayPal”, “Payflow”, and related marks are trademarks of their respective owners. Production usage requires valid API credentials and adherence to
PayPal policies and applicable PCI-DSS rules. For official updates and vendor support, purchase a license from the original developer.