Installation

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

  • If you have OXID eShop version 6.3.x or higher, install PayPal Checkout 2.2.x.

  • If you have OXID eShop version 6.1.x or 6.2.x, install PayPal Checkout 1.2.x.

Versions of OXID eShop prior to version 6.1 are not supported.

Installing PayPal Checkout for OXID eShop version 6.3 and higher

Install the payment module PayPal Checkout for OXID eShop version 6.3 and higher.

Prerequisites

  • You have installed OXID eShop 6.3 or higher.

  • 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

  1. Open a shell and change to the root directory of the eShop (where the file composer.json is located).
    Example:

    cd /var/www/oxideshop
    
  2. Execute the following commands:

    composer config repositories.oscpaypal composer https://paypal-module.packages.oxid-esales.com/
    composer require oxid-solution-catalysts/paypal-module ^2.2.0
    
  3. 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).

PayPal Checkout for OXID installed successfully

Figure: PayPal Checkout for OXID installed successfully

Next step: To configure PayPal Checkout, choose Next.

Installing PayPal Checkout for OXID eShop version 6.1.x or 6.2.x

To install PayPal Checkout for OXID eShop version 6.1.x or 6.2.x, install PayPal Checkout V. 1.2.x.

Procedure

Follow the same procedure for installation for OXID eShop version 6.3 and higher (see Installing PayPal Checkout for OXID eShop version 6.3 and higher).

Execute the commands as follows:

composer config repositories.oscpaypal composer https://paypal-module.packages.oxid-esales.com/
composer require oxid-solution-catalysts/paypal-module ^1.2.0

Installing a Minor Update

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

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

Installing a patch update

If required, install a patch update, from PayPal Checkout version 2.1.4 to version 2.1.5, for example.

Procedure

  1. Execute the following command:

    composer update
    
  2. 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:

  1. Choose Shop Settings ‣ Payment Methods ‣ <payment method> ‣ Country ‣ Assign Countries.

  2. To use the entire country coverage of a payment type, delete existing mappings.