PrestaShop: How to configure PayPal

Sure 🙂 here’s a clear, step-by-step guide to configure PayPal in PrestaShop (1.7 / 8.x).

---

1️⃣ Install the PayPal module

1. Go to Back Office → Modules → Module Manager
2. Search for PayPal
3. Install “PayPal Official” (by PayPal / PrestaShop)
4. Click Configure

👉 If not found:

• Go to Modules → Marketplace
• Search PayPal Official
• Download & install

---

2️⃣ Choose PayPal account type

During setup you’ll be asked to select:

• PayPal Business account ✅ (required)
• Country & currency

⚠️ Personal PayPal accounts will NOT work for live payments.

---

3️⃣ Connect PayPal account (recommended)

Option A: Automatic connection (best)

1. Click Connect with PayPal
2. Login to your PayPal Business account
3. Approve permissions

✔ This auto-configures:

• API credentials
• Webhooks
• IPN

---

Option B: Manual API credentials (advanced)

If automatic fails:

1. PayPal Dashboard → Settings
2. Account Settings → API Access
3. Create:
   • Client ID
   • Secret
4. Paste into PrestaShop PayPal module

---

4️⃣ Select environment (Sandbox / Live)

In module configuration:

• Sandbox → for testing
• Live → for real payments

💡 Always test in Sandbox first.

---

5️⃣ Enable payment methods

You can enable:

• ✅ PayPal Wallet
• ✅ Credit / Debit Cards (no PayPal account needed)
• ✅ Pay Later (EMI – country dependent)

Back Office → PayPal → Payment Options

---

6️⃣ Configure order status mapping

Set correct order states:

• Payment accepted
• Pending
• Refunded
• Canceled

Path:
PayPal module → Advanced Settings → Order status

---

7️⃣ Enable currencies

Go to:
International → Localization → Currencies

✔ Make sure your store currency is supported by PayPal
(INR, USD, EUR, GBP, etc.)

---

8️⃣ Position PayPal on checkout

1. Design → Positions
2. Ensure PayPal is hooked to:
   • displayPayment
   • displayExpressCheckout (optional)

---

9️⃣ Test PayPal (Sandbox)

1. Create Sandbox accounts in:
   • https://developer.paypal.com
2. Use:
   • Sandbox buyer email
   • Sandbox password
3. Place a test order

✔ Order should appear in:

• PrestaShop Orders
• PayPal Sandbox dashboard

---

🔧 Common issues & fixes

❌ PayPal not showing at checkout

• Currency not supported
• Module not hooked correctly
• Customer group restriction

❌ Payment completed but order pending

• IPN/Webhook blocked
• Server firewall issue
• HTTPS missing

❌ Redirect loop / white screen

• Clear cache
• Disable overrides
• Check PHP version (7.4–8.1 recommended)

---

✅ Best practices

• Use official PayPal module only
• Enable HTTPS
• Keep module updated
• Avoid multiple PayPal modules at once

---

👌