Installation

To install the PayPal Checkout payment module, install different versions depending on your OXID eShop version:

If you have OXID eShop version 6.3.x to 6.5.x, install PayPal Checkout 2.3.x (see Installing PayPal Checkout).
If you have OXID eShop version 7.x, install PayPal Checkout 3.3.x.
For more Informationen, see the corresponding module documentation under Installing PayPal Checkout 3.3.x.
If you have OXID eShop version 6.1.x or 6.2.x, install PayPal Checkout 1.3.x.
For more Informationen, see the corresponding module documentation under Installing PayPal Checkout 1.3.x.

Earlier versions of OXID eShop are not supported.

Installing PayPal Checkout

For OXID eShop version 6.3 and higher, install the payment module PayPal Checkout version 2.3.x.

Prerequisites

You have installed OXID eShop version 6.3.x to 6.5.x.
You have configured https.
1. In the <root directory of the eShop>/source directory, open the config.inc.php file.
2. Make sure that https is set for the base URL (shopURL parameter).
  Example:
  $this->sShopURL = 'https://www.example.org';

Procedure

Open a shell and change to the root directory of the eShop (where the file composer.json is located).
Example:
```
cd /var/www/oxideshop
```

Execute the following commands:

composer require oxid-solution-catalysts/paypal-module ^2.3.0

Optional: To activate the module, run the following command.
Alternatively: Activate the module manually during configuration (see Activating PayPal Checkout).
```
./vendor/bin/oe-console oe:module:activate osc_paypal
```

Result

When the installation process is finished, the module PayPal Checkout for OXID appears in the administration area under Extensions ‣ Modules (Figure: PayPal Checkout for OXID installed successfully).

If you use a deprecated version, perform a minor update, for example from PayPal Checkout version 2.2.1 to version 2.3.0.

composer require oxid-solution-catalysts/paypal-module ^2.3.0
composer update

If required, install a patch update, from PayPal Checkout version 2.3.0 to version 2.3.1, for example.

Procedure

Execute the following command:
```
composer update
```
Confirm the prompt whether to overwrite the oxid-solution-catalysts/paypal-module files.

Attention

Check country mappings after update to PayPal Checkout version 2.1.5.

With version 2.1.4 the country coverage of individual PayPal Checkout payment methods has been extended.

Make sure that you can use the extended country coverage.

Background: With PayPal Checkout version 2.1.5, countries are automatically assigned to payment methods during initial installation (see Optional: Configuring the country mapping of PayPal Checkout payment methods).

This may cause configuration settings of your existing version to block the use of extended country mappings.

Do the following:

Choose Shop Settings ‣ Payment Methods ‣ <payment method> ‣ Country ‣ Assign Countries.
To use the entire country coverage of a payment type, delete existing mappings.