PayPal RESTful API Payment Module

[cheddars]

I am receiving errors regularly for paypal restful (encapsualted version). Your help to resolve them would be very much appreciated. I am using :
ZC 2.2.2 (fresh install)
Bootstrap 3.7.10 template
PHP 8.2.31
MySQL 10.3.39-MariaDB
Paypal Express Checkout is set to 'retired' although I had the same problems when this was not installed
Various other plugins installed inc Ceon URI mapping and Royal Mail
A typical example of the errors:-

[02-Jun-2026 08:20:43 UTC] Request URI: /ipn_main_handler.php, IP address: 173.0.81.140, Language id 1
#0 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/ipn_main_handler.php(352): zen_debug_error_handler()
--> PHP Warning: Undefined array key "payment" in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/ipn_main_handler.php on line 352.

[02-Jun-2026 08:20:43 UTC] PHP Fatal error:  Uncaught Error: Class "PayPalRestful\Common\ErrorInfo" not found in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/zc_plugins/PayPalRestful/v2.0.0/catalog/includes/modules/payment/paypalr.php:214
Stack trace:
#0 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/includes/classes/payment.php(121): paypalr->__construct()
#1 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/ipn_main_handler.php(352): payment->__construct()
#2 {main}
  thrown in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/zc_plugins/PayPalRestful/v2.0.0/catalog/includes/modules/payment/paypalr.php on line 214

[02-Jun-2026 08:20:43 UTC] Request URI: /ipn_main_handler.php, IP address: 173.0.81.140
--> PHP Fatal error: Uncaught Error: Class "PayPalRestful\Common\ErrorInfo" not found in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/zc_plugins/PayPalRestful/v2.0.0/catalog/includes/modules/payment/paypalr.php:214
Stack trace:
#0 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/includes/classes/payment.php(121): paypalr->__construct()
#1 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/ipn_main_handler.php(352): payment->__construct()
#2 {main}
  thrown in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/zc_plugins/PayPalRestful/v2.0.0/catalog/includes/modules/payment/paypalr.php on line 214.

[02-Jun-2026 08:20:43 UTC] Request URI: /ipn_main_handler.php, IP address: 173.0.81.140
--> PHP Fatal error: Uncaught Error: Class "PayPalRestful\Common\ErrorInfo" not found in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/zc_plugins/PayPalRestful/v2.0.0/catalog/includes/modules/payment/paypalr.php:214
Stack trace:
#0 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/includes/classes/payment.php(121): paypalr->__construct()
#1 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/ipn_main_handler.php(352): payment->__construct()
#2 {main}
  thrown in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/zc_plugins/PayPalRestful/v2.0.0/catalog/includes/modules/payment/paypalr.php on line 214.

[lat9]

@cheddars, were you doing any cleanup on the older PayPal transactions in the admin at the time of the errors? The issue lies with the paypalwpp/paypaldp's ipn_main_handler.php and I'm just trying to figure out how its being called to provide the "right" correction.

[lat9]

GitHub tracking issue: https://github.com/zencart/zencart/issues/7767

[cheddars]

@lat9 thank you for responding so quickly.
I have not made any changes to PHP files although I have copied over database tables from a previous ZC 156 system (paypal and paypal_payment_status_history and orders).
The errors are generated on a regular basis (presumably during normal customer operations). I have not made any admin changes recently.

[DrByte]

@cheddars,
Do you have the ExpressCheckout or DirectPayment modules "enabled" (or even set to "retired") instead of clicking Uninstall/Remove to completely deactivate them?
If you've "recently" (last 60 days) done transactions in the older PayPal modules and want to be able to inspect PayPal details via your store, you'd need it left set to "Retired".
But if none of your payment/order history with those modules is within the last 60 days, you wouldn't need to keep the old module enabled/retired at all, and can click Remove/Uninstall. And then the ipn_main_handler shouldn't fire either.

So, I'm just inquiring the state of your historical orders: will you need to review PayPal details on "recent" orders via your store's Admin? If not, you can remove those old PayPal modules. You can still explore actual transaction details and even do refunds on them directly from your PayPal account even if the old module is removed from your store.

[cheddars]

Thank you @DrByte
Currently I have Paypal Express checkout set to 'retired' and I do have transactions within the last month. However there are not too many of them and so removing the module should not be a problem if I need to make a refund.
I shall uninstall Paypal Express and see how it goes

[cheddars]

After uninstalling Paypal Express I still get the same error message logged

[cheddars]

After uninstalling Paypal Express I still get the same error message logged

I should add, this was after applying the temporary fix suggested by @lat9
I have now captured 2 payments and received the following warnings :-

[03-Jun-2026 09:25:57 UTC] Request URI: /ipn_main_handler.php, IP address: 173.0.81.140, Language id 1
#0 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/includes/modules/payment/paypal/paypal_functions.php(402): zen_debug_error_handler()
#1 /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/ipn_main_handler.php(496): ipn_create_order_update_array()
--> PHP Warning: Undefined array key "pending_reason" in /var/www/vhosts/xxxxxxxxx.co.uk/httpdocs/includes/modules/payment/paypal/paypal_functions.php on line 402.

[lat9]

v1.3.2 of the non-encapsulated version of the PayPal RESTful payment module is now available for download: https://www.zen-cart.com/downloads.php?do=file&id=2382

This release contains changes associated with these GitHub issues:

#114: Sync with changes from the encapsulated version of the payment module.
#116: zcDate not loaded during webhook actions
#118: Wrong amount shown for PayLater messaging
#119: CC obfuscation modified for BIN lookups

[lat9]

v2.1.0 of the encapsulated version of the PayPal RESTful payment module is now available for download: https://www.zen-cart.com/downloads.php?do=file&id=2434

This release contains changes associated with these GitHub issues: https://github.com/zencart/paypalr/i...stone%3Av2.1.0
Highlights:

• Adds support for zc300's zen_config function (with polyfill for previous Zen Cart versions)
• Corrects incorrect amounts for PayLater messaging on product pages.
• Modifies the credit-card obfuscation to account for BIN lookups
• Correction of various PHP logs and "hardening" of external input entries.