=== Bookster PayPal Addon ===
Contributors: bookster
Donate link: https://wpbookster.com/
Tags: online payments, appointments, paypal, payments, checkout
Requires at least: 5.2
Tested up to: 7.0
Stable tag: 3.2.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Accept PayPal online payments at Bookster checkout

## Description

Accept PayPal payments directly in your Bookster booking form. 

📌 [View Demo](https://demo.wpbookster.com/consulting/)

With this plugin, your clients and customers can pay easily with credit cards, debit cards, or PayPal balance. A secure checkout is now integrated seamlessly into your appointment booking process.

### Who This Is Perfect For

* Hair salons requiring deposits to reduce no-shows
* Consultants collecting payment before sessions
* Fitness trainers taking class payments upfront
* Tutors accepting lesson payments in advance
* Any service business that wants guaranteed payment when customers book

## 🔷 Key Features

### Quick Setup (No Coding Required)

Install the addon, get your PayPal API credentials, paste them into the settings, and you're done. The entire setup takes about 5 minutes following our step-by-step guide in the **Installation** tab.

### Secure & Trusted

* All payment processing happens on PayPal's secure servers (PCI-compliant)
* Customer credit card information never touches your WordPress site
* Customers stay on your site during checkout (embedded PayPal experience)
* SSL/HTTPS automatically enforced for payment pages

### Seamless Integration

* PayPal button appears automatically in your existing booking forms
* Customers complete payment without leaving your website
* Works with all Bookster features (multiple services, staff selection, custom fields)

### Professional Customer Experience

* Instant payment confirmation emails sent automatically
* Customers receive PayPal receipt plus your booking confirmation
* Clear payment status shown in customer dashboard


== Installation ==
## Installation

### Requirements Check

Before installing, verify you have:
* ✅ Bookster core plugin version 2.2.0 or higher (check **Plugins → Installed Plugins**)
* ✅ WordPress 5.0 or higher
* ✅ PayPal Business account (create free at paypal.com if needed)

### Step 1: Install the Addon

**Quick Install:**
1. Go to **Plugins → Add New**
2. Search for "Bookster PayPal"
3. Click **Install Now** next to Bookster PayPal Addon
4. Click **Activate** when installation completes

**Upload ZIP:**
1. Go to **Plugins → Add New**
2. Click **Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Click **Activate Plugin**

### Step 2: Get Your PayPal API Credentials

You need two pieces of information from PayPal: Client ID and Client Secret.

1. Log in to your PayPal Business account at paypal.com
2. Click **My Apps & Credentials** in top menu
3. Copy the **Client ID** shown
4. In WordPress, go to **Bookster → Settings → Payment**
5. Enable PayPal and paste your Client ID and Client Secret respectively.

### Step 3: Test and go live

Before going live, test the payment flow:

1. Keep API Mode set to **Sandbox**
2. Create a PayPal Sandbox test account at developer.paypal.com
3. Visit your booking page and create a test appointment
4. Use sandbox test credentials when checking out
5. Verify the booking appears as "Paid" in **Bookster → Calendar**
6. Check that you received confirmation emails

When testing works perfectly:
1. Return to **Bookster → Settings → Payment**
2. Change API Mode to **Live**
3. Click **Save Settings**
4. You're now accepting real payments!

## Frequently Asked Questions

### Do customers need a PayPal account to pay?

No. Customers can pay with any credit or debit card without creating a PayPal account. When they click "Pay with PayPal", they see options to either log in to PayPal OR pay as a guest with a card.

### What happens if a payment fails?

The booking is not confirmed. The customer sees an error message and can either:

* Try again with a different payment method
* Update their payment information
* Contact you directly

You won't see failed payment attempts in your bookings list, only successful payments create confirmed bookings.

### Are there PayPal fees?

Yes, PayPal charges standard processing fees (usually around 2.9% + $0.30 per transaction in the US). These fees are deducted from what you receive. Check PayPal's current rates for your country at paypal.com/fees.

### Can I use this with Bookster's free version?

Yes! This addon works perfectly with the free Bookster plugin. You don't need Bookster Pro to accept PayPal payments.

### What's the difference between Sandbox and Live mode?

* **Sandbox Mode**: For testing. Uses fake money and test PayPal accounts. Transactions aren't real.
* **Live Mode**: For real business. Uses your actual PayPal account and processes real payments.

Always test in Sandbox mode first before switching to Live.


== Screenshots ==
1. Fill out your PayPal account info in Bookster settings

== Changelog ==

= Apr 22, 2026 - Version 3.2.0 =
- Improved: Work with Bookster Core 3.2.0

= Mar 9, 2026 - Version 3.0.0 =
- Improved: Integrate with Bookster v3 Addon Page
- Improved: Update several libraries

= Jan 07, 2026 – Version 2.2.0 =
- New: Integrate with the Booking Template addon
- Improved: Better Booking Form UI

= Feb 21, 2025 – Version 2.1.0 =
- Improved: Compatible with Bookster version 2.1.0
- Improved: UI/UX

= Oct 2, 2024 - Version 2.0.0 =
- Added: Compatibility with Bookster v2.0.0

= Aug 14, 2024 - Version 1.0.1 =
- Improved: UI
- Compatible with Bookster version 1.3.0

= Jul 17, 2024 - Version 1.0.0 =