zerofront / module-zero-paypal

1.3.6 2026-10-31 21:15 UTC

Requires

• php: ~8.2.0||~8.3.0||~8.4.0
• magento/framework: 103.0.*
• magento/module-checkout: *
• magento/module-config: *
• magento/module-directory: *
• magento/module-payment: *
• magento/module-paypal: *
• magento/module-quote: *
• magento/module-sales: *
• magento/module-store: *
• zerofront/module-zero-checkout: ^1.3.6
• zerofront/module-zero-core: ^1.3.6

Replaces

• fixstacks/module-zero-paypal: 1.3.6

OSL-3.0, AFL-3.0

• Roman Pasichnyk

• payment
• paypal
• magento
• zero
• magento2
• magento-open-source

Published on Packagist.org on 2026-10-31 21:19 UTC

README

PayPal for Zero Checkout, two methods. Both send the buyer to PayPal after the order is placed; neither needs JavaScript on the shop's pages.

Method	Code	Credentials	How it confirms
PayPal Checkout	zero_paypal_checkout	REST app: client ID and secret	Captured by the shop when the buyer comes back
PayPal (classic redirect)	zero_paypal_standard	Business account email only	PayPal's IPN (Magento's paypal/ipn)

Install

Requires Magento Open Source 2.4.7–2.4.9 and PHP 8.2–8.4 with the GD extension built with WebP (php -r 'var_dump(function_exists("imagewebp"));' says true; Magento's own PHP requirements cover the rest). Without WebP in GD, Zero skips its WebP image copies and serves the originals.

composer require zerofront/module-zero-paypal
bin/magento setup:upgrade
bin/magento setup:di:compile           # production mode
bin/magento setup:static-content:deploy # production mode
bin/magento cache:flush

Composer installs zerofront/module-zero-core, zerofront/module-zero-checkout with it.

Part of zerofront/zero, which installs the Zero theme and every Zero module at once.

PayPal Checkout

PayPal's Orders API v2 over Magento's HTTP client, no SDK. On PayPal's page the buyer pays with the PayPal balance, a card, or Pay Later where PayPal offers it in the buyer's country.

1. Placing the order creates a PayPal order (intent CAPTURE) for the grand total in the order's currency; the Magento order waits in pending payment and the buyer goes to PayPal's approval page.
2. Back on the return URL (zero_paypal/checkout/return) the shop captures, under the order's lock (Zero_Checkout's ReturnFlow): COMPLETED for the order's amount and currency: paid (invoice, order email). A capture PayPal holds for review leaves the order pending with a comment. Declined or never approved: cancelled, the cart restored. The capture's PayPal-Request-Id comes from the request itself, so a repeated return never captures twice.
3. Cancelled on PayPal (zero_paypal/checkout/cancel): under the same lock, an order still waiting is cancelled and the cart restored; one already paid (another tab) goes to the success page.

No money is taken without the capture, so a buyer who never comes back pays nothing; no webhook is needed, and the method is not in Zero_Checkout's Updaters (pull-capture: the cron has nothing to ask). Refunds: credit memos refund the capture online, in the order's currency (the credit memo's total). Each refund's PayPal-Request-Id is Zero_Checkout's RefundKey (zero-<order>-r<refunded so far>-<amount>): a retry of the same credit memo gets PayPal's first answer back instead of refunding twice, and the next partial refund is a new request.

Settings: Stores > Configuration > Sales > Payment Methods > PayPal Checkout (Zero): Enabled, Title, Client ID, Secret (encrypted; developer.paypal.com > Apps & Credentials), Sandbox (on by default).

PayPal (classic redirect)

See Model/Standard.php: the _xclick redirect with a business email, made paid by PayPal's IPN. The cancel URL (zero_paypal/standard/cancel) cancels the checkout session's last order and restores the cart only when it is a zero_paypal_standard order still pending payment (or new), under the order's lock; anything else (paid meanwhile by the IPN, another method) is left alone and the customer goes back to the checkout page.

What changed in each release: CHANGELOG.md.

License

OSL-3.0 or AFL-3.0, your choice: see NOTICE.md.

Zero is made by Fixstacks in partnership with Vilmate, a software development company. Documentation: https://zerofront.dev/docs. Demo store: https://demo.zerofront.dev.