Zen Cart PayPal Not Working — 7 Fixes

This is the single most frequent PayPal issue we see. Sandbox mode lets you test PayPal without real money — but if it's left on when the store goes live, all payments go to a test environment and nothing is processed.

To check and fix this in Zen Cart:

1. Log into your Zen Cart admin panel
2. Go to Modules → Payment
3. Click on PayPal Express Checkout (or whichever PayPal module you use) → Edit
4. Find the Transaction Server or Environment setting
5. Change it from Sandbox / Test to Live / Production
6. Save, then test with a real payment

PayPal uses IPN to tell your Zen Cart store when a payment is completed. If IPN isn't set up, customers can pay successfully but no order record is created in Zen Cart — it's as if the payment never happened from the store's point of view.

To set up IPN in your PayPal account:

1. Log into your PayPal Business account
2. Go to Account Settings → Notifications → Instant Payment Notifications
3. Click Update and enable IPN
4. Set the notification URL to: https://yourstore.com/ipn_main_handler.php
5. Save the settings

PayPal requires a valid, active SSL certificate to process payments. If your SSL has expired, is self-signed, or doesn't cover your exact domain (including or excluding www), PayPal will refuse to complete the transaction.

How to diagnose:

• Visit your store at https://yourstore.com — does the browser show a padlock with no warning?
• Check your SSL at SSL Labs — it should return an A or B rating
• Check that your Zen Cart configure.php HTTP_SERVER and HTTPS_SERVER both use https://

If your SSL has expired, renew it through your hosting provider. Most hosts offer free Let's Encrypt SSL — ask your host to enable it if it's not already.

PayPal periodically updates its API and deprecates older integration methods. If you're running an old version of the Zen Cart PayPal module, it may no longer communicate properly with PayPal's servers.

Specifically: PayPal deprecated its Classic API (which older Zen Cart PayPal modules used) in 2021. Stores running Zen Cart 1.5.4 or earlier with the original PayPal module may experience increasing payment failures.

The fix depends on your Zen Cart version:

• Zen Cart 1.5.7+: Update the PayPal module from zen-cart.com/downloads
• Zen Cart 1.5.6 and earlier: Consider upgrading to Zen Cart 2.2.2 which ships with an updated PayPal Commerce Platform module
• Zen Cart 2.x: Use the built-in PayPal Commerce Platform module — it uses the current PayPal API

Zen Cart's PayPal configuration requires your exact PayPal Business email address. If there's any mismatch — even a capital letter difference — payments may fail or go to the wrong account.

1. In Zen Cart admin, go to Modules → Payment → PayPal Express Checkout → Edit
2. Check the Business Account Email field
3. Log into PayPal and confirm your exact account email under Account Settings → Email
4. Make sure they match exactly — copy-paste rather than typing it manually

Zen Cart uses PHP's cURL library to communicate with PayPal's API. If cURL is disabled on your server, all PayPal API calls will silently fail.

To check if cURL is enabled, create a temporary phpinfo.php file (see the blank page guide) and search for "curl" on the page. You should see "cURL support: enabled".

If cURL is not enabled, contact your hosting provider and ask them to enable the PHP cURL extension. This is a standard request on any modern shared host and should take minutes.

If you're using PayPal Standard (not Express Checkout), the PDT token is what allows Zen Cart to verify payment completion when the customer returns to your store after paying. Without a valid token, orders may not be confirmed even when payment succeeds.

1. In your PayPal account, go to Account Settings → Website Payments → Website Preferences
2. Enable Auto Return and set the return URL to: https://yourstore.com/index.php?main_page=checkout_process
3. Enable Payment Data Transfer and copy the Identity Token shown
4. In Zen Cart admin → Modules → Payment → PayPal, paste this token into the PDT Identity Token field