README

Features

PayPal is available as a regular payment method in the appropriate checkout step.
PayPal express is already included at the checkout (registration step), at the so called “mini cart” and at the product detail pages.
The module is highly customizable through many options at the admin panel, for example the step to transfer the money (at the order date or on delivery).
The payment page at PayPal can be customized by your own logo and the name of your online store.
If you wish, you can transfer the content of the cart (purchased product items) to PayPal. Your customer has to decide whether this data shall be transferred or not.
Partial payment is possible.
The admin panel provides an overview of the PayPal payments per order.

Setup

System requirements and installation instructions are described in the module documentation: https://docs.o3-shop.com/modules/paypal/en/6.0/installation.html.

Module installation via composer

In order to install the module via composer run one of the following commands in commandline in your shop base directory (where the shop's composer.json file resides).

composer require o3-shop/paypal-module:^1.0.0 to install the released version compatible with O3-Shop Compilation 1.x
- Please note that PayPal ^v1.0.0 is compatible with GraphQL Storefront ^v2.0.0.

Running tests locally

To run this module tests locally, ensure the test_config.yml values are correct:

Set partial_module_paths to oe/oepaypal
Set activate_all_modules to true
Set run_tests_for_modules to true
Set run_tests_for_shop to false
Set additional_test_paths to ''
Set retry_times_after_test_fail to 0

For running acceptance tests you need to provide sandbox credentials data in oepaypal/Tests/Acceptance/oepaypalData.php file:

Set sOEPayPalSandboxUsername
Set sOEPayPalSandboxPassword
Set sOEPayPalSandboxSignature
Set sBuyerLogin
Set sBuyerPassword
Set OEPayPalClientId

For running codeception tests you need to provide sandbox credentials data in oepaypal/Tests/Codeception/_data/oepaypalData.php file:

Set sOEPayPalSandboxUsername
Set sOEPayPalSandboxPassword
Set sOEPayPalSandboxSignature
Set sBuyerLogin
Set sBuyerPassword
Set OEPayPalClientId

For running codeception tests in test group paypal_graphql, you need the GraphQL Storefront module installed and the following settings in the test_config.yml:

Set partial_module_paths to oe/graphql-base,oe/graphql-storefront,oe/oepaypal
Set activate_all_modules to true
Set run_tests_for_modules to true
Set run_tests_for_shop to false
Set additional_test_paths to ''

For running the tests and more configuration options, follow the instructions from here.

Bugs and Issues

If you experience any bugs or issues, please report them in the section module PayPal of https://issues.o3-shop.com.

Documentation

The module documentation can be found on our documentation platform: https://docs.o3-shop.com/modules/paypal/en/6.3/index.html.

o3-shop / paypal-module

Maintainers

Details