PayPal RESTful API Payment Module

[lat9]

This Zen Cart payment module (paypalr) combines the processing for the PayPal Payments Pro (paypaldp) and PayPal Express Checkout (paypalwpp) payment modules that are currently built into Zen Cart distributions. Instead of using the older NVP (Name Value Pair) methods to communicate with PayPal, this payment module uses PayPal's now-current REST APIs and combines the two legacy methods into one.

Zen Cart Support Thread: https://www.zen-cart.com/forumdisplay.php?170-PayPal-RESTful-support

Zen Cart Plugin Download Link: https://www.zen-cart.com/downloads.php?do=file&id=2382

The module's operation has been validated …

1. With PHP versions 7.4 through 8.3; PHP 7.3 will result in fatal PHP errors!
2. In Zen Cart's 3-page checkout environment (v1.5.8a and v2.0.0)
3. With One-Page Checkout (OPC), v2.4.6
   
   1. Using OPC's guest-checkout feature.
   2. Both requiring confirmation and not!
   
   
4. With both the built-in responsive_classic and ZCA Bootstrap (v3.6.1) templates.

For additional information, refer to the payment-module's wiki articles.

[lat9]

Please note: The current release (v1.0.0-beta4) is a beta version! While I've tested it extensively, I suggest giving it a try on your test site using a PayPal sandbox account first.

[swguy]

More documentation:

https://docs.zen-cart.com/user/payment/paypal_overview/

https://docs.zen-cart.com/user/payment/paypal_restful/

[swguy]

Credit to @lat9 for undertaking this labor of love.

Updated integrations with UPS, FedEx, USPS and now PayPal will give Zen Cart - and your stores - a new lease on life.

[mprough]

Zen Cart 1.5.8
Bootstrap 3.5.0
OPC 2.4.5
PHP 7.4.33

Payment modules installed: freecharger, moneyorder & paypalr
Order total modules installed: ot_shipping, ot_coupon, ot_subtotal, ot_tax & ot_subtotal
Shipping modules installed: freeshipper & usps

Other modules installed: RCS, Sales Report w/ Graphs & IH5.

Guest checkout, first test after configuration, clicked PayPal button... no checkbox/radio button seems very confusing with the express button on the checkout/payment page. The button is clickable, but goes no where.




So I click it, then confirm order and it fails to the following page & error.


Page Not Found
https://domain.com/cart/ppr_webhook_...=B8KWPQT6BCWP8

The logs looks very much like it completed its work... last few lines

2024-01-15 13:36:02: (checkout_one_confirmation) ==> End confirmPaymentSource
2024-01-15 13:36:02: (checkout_one_confirmation) pre_confirmation_check, sending the payer-action off to PayPal.

[lat9]

You missed the root-directory file ppr_webhook_main.php; that's where the 404 came from. Zen Cart 1.5.8 or 1.5.8a?

[mprough]

You missed the root-directory file ppr_webhook_main.php; that's where the 404 came from. Zen Cart 1.5.8 or 1.5.8a?

1.5.8

Sure did miss, thank a bunch!

~Melanie

[Webskipper]

Will this be part of the ZC 2.0 release?

[lat9]

Will this be part of the ZC 2.0 release?

Nope, it needs to "get its feet wet" before committing to core.

[simon1066]

ZC 1.5.8a
PHP 8.1.27
PayPal Checkout (RESTful) 1.0.1
OPC 2.4.6
Square WebPay 1.2.0

I get this warning when voiding a transaction

[20-Mar-2024 14:29:00 Europe/London] Request URI: /MY_ADMIN/index.php?cmd=orders&page=1&oID=1391&action=doVoid, IP address: xx.xx.xx.xx, Language id 1
#0 /home/MY_DOMAIN/public_html/includes/modules/payment/paypal/PayPalRestful/Admin/DoVoid.php(92): zen_debug_error_handler()
#1 /home/MY_DOMAIN/public_html/includes/modules/payment/paypalr.php(1912): PayPalRestful\Admin\DoVoid->__construct()
#2 /home/MY_DOMAIN/public_html/MY_ADMIN/orders.php(405): paypalr->_doVoid()
#3 /home/MY_DOMAIN/public_html/MY_ADMIN/index.php(11): require('...')
--> PHP Warning: Undefined variable $last_auth_txn in /home/MY_DOMAIN/public_html/includes/modules/payment/paypal/PayPalRestful/Admin/DoVoid.php on line 92.

[20-Mar-2024 14:29:00 Europe/London] Request URI: /MY_ADMIN/index.php?cmd=orders&page=1&oID=1391&action=doVoid, IP address: xx.xx.xx.xx, Language id 1
#0 /home/MY_DOMAIN/public_html/includes/modules/payment/paypal/PayPalRestful/Admin/DoVoid.php(92): zen_debug_error_handler()
#1 /home/MY_DOMAIN/public_html/includes/modules/payment/paypalr.php(1912): PayPalRestful\Admin\DoVoid->__construct()
#2 /home/MY_DOMAIN/public_html/MY_ADMIN/orders.php(405): paypalr->_doVoid()
#3 /home/MY_DOMAIN/public_html/MY_ADMIN/index.php(11): require('...')
--> PHP Warning: Trying to access array offset on value of type null in /home/MY_DOMAIN/public_html/includes/modules/payment/paypal/PayPalRestful/Admin/DoVoid.php on line 92.

and because of this (I assume) the Trans ID is blank in the admin orders 'voided' comments block

----------------------------
VOIDED. Trans ID: [blank]
Transaction voided.
----------------------------