o3-shop / paypal-checkout

v1.7.0 2026-11-05 21:36 UTC

Requires

• php: ^7.4|^8.0|^8.1
• giggsey/libphonenumber-for-php: ^8.12
• o3-shop/paypal-client: ^1.0
• o3-shop/shop-ce: ~1.7.0
• symfony/event-dispatcher: *
• viison/address-splitter: ^0.3.4
• webmozart/path-util: ^2.3.0

Requires (Dev)

• phpmd/phpmd: ^2.11
• phpstan/phpstan: ^1.10
• squizlabs/php_codesniffer: 3.*
• symfony/dotenv: *

Conflicts

• oxid-esales/oxideshop-ce: <6.8 | ^7.0

Replaces

• oxid-solution-catalysts/paypal-module: v1.7.0

GPL-3.0-only

• O3-Shop
• OXID eSales AG

• payment
• modules
• paypal
• eshop
• OXID

Published on Packagist.org on 2026-11-05 22:29 UTC

README

PayPal checkout integration for OXID eShop 6.1 and above.

Documentation

• Official German PayPal Checkout for OXID 6.1 to 6.2 documentation
• Official German PayPal Checkout for OXID 6.3 to 6.5 documentation
• Official German PayPal Checkout for OXID from 7.0 documentation
• Official English PayPal Checkout for OXID 6.1 to 6.2 documentation
• Official English PayPal Checkout for OXID 6.3 to 6.5 documentation
• Official English PayPal Checkout for OXID from 7.0 documentation

Technical documentation in this repository: docs/README.md - architecture, payment flows, order states, webhook system, UML diagrams and troubleshooting.

Branch Compatibility

• b-7.0.x module branch is compatible with OXID eShop compilation 7.0, 7.1, 7.2, 7.3, 7.4
• b-6.3.x module branch is compatible with OXID eShop compilation 6.3, 6.4, 6.5
• b-6.1.x module branch is compatible with OXID eShop compilation 6.1, 6.2

Install for OXID

• see Official documentation

Install for O3-Shop

The module requires o3-shop/paypal-client in the version named in LATEST_CLIENT_TAG (^1.0). Both packages are on Packagist, so no extra repositories entry is needed:

composer require o3-shop/paypal-checkout

Release order: tag the client version from LATEST_CLIENT_TAG first, then release the module whose composer.json requires it. A module tag that requires an untagged client version cannot be installed.

Limitations

• no limitations

Merging Strategy

• The b-6.3.x branch is compatible with OXID6.3 to 6.5 and will not be merged automatically into the b-7.0.x branch
• if something changes in the b-6.3.x main branch, it must be ported to the b-7.0.x branch

Running tests

Warning: Running tests will reset the shop.

Requirements

• Ensure test_config.yml is configured:

  partial_module_paths: osc/paypal
  

  activate_all_modules: true
  run_tests_for_shop: false
  run_tests_for_modules: true
  

Run

Running phpunit tests:

vendor/bin/runtests

Running phpunit tests with coverage reports (report is generated in .../paypal/Tests/reports/ directory):

XDEBUG_MODE=coverage vendor/bin/runtests-coverage

CodeStyle commands

The following Composer commands are available for checking and maintaining code quality:

PHP Mess Detector (PHPMD)

• composer md - Run PHPMD checks on locally modified files
• composer md:commit - Run PHPMD checks on files changed in the last commit

PHPStan

• composer stan - Run static analysis checks on locally modified files
• composer stan:commit - Run static analysis checks on files changed in the last commit

PHP CodeSniffer (PHPCS)

• composer cs - Run coding standards checks on locally modified files
• composer cs:commit - Run coding standards checks on files changed in the last commit

Combined Checks

• composer style - Run all code quality checks (PHPMD, PHPStan, and PHPCS) on locally modified files
• composer style:commit - Run all code quality checks on files changed in the last commit

Each command has two variants:

• Default version checks files that have local modifications but haven't been committed
• :commit suffix version checks only the files that were changed in the most recent commit

These commands help maintain consistent code quality by checking:

• Code style and formatting (PHPCS)
• Potential problems and complexity issues (PHPMD)
• Type safety and potential bugs (PHPStan)