PayPal

The PayPal plug-in offers you the possibility to provide your customers with the most common PayPal payment methods.

Installation

The PayPal plug-in can be installed in different ways.

Firstly, you can obtain and configure the plug-in directly during the installation of shopware in the first run wizard.

On the other hand, you can go to the Shopware Store in Admin under Settings > System > Plugins > Shopware Store and search for the current PayPal plug-in and then install it in your shop. Alternatively, you can also download the PayPal plug-in directly from the Shopware Store at store.shopware.com.

General configuration

You can configure PayPal in the admin under Settings > Plugins by clicking on PayPal.

Sales Channel Switch

In this drop down menu you can define for which sales channels the settings should be made. You can choose between all sales channels or a single sales channel.

Configuring the API settings

In the next step you have to enter your PayPal access data received from PayPal.

Client-ID (1): Here you enter the PayPal REST-ID. It is used by the plug-in to authenticate itself with the PayPal API.

Client-Secret (2): Enter the REST-API client secret here, which the plug-in also uses to authenticate itself with the PayPal API.

Test API credentials (3): With the help of this button you can test the credentials you have entered. The result of the test is displayed directly in the Save button.

Enable sandbox (4): Check this box if you just want to test the PayPal integration. Please note that the sandbox environment has its own access data.

Sandbox-client id (5): Here you enter the PayPal Sandbox REST-ID This is used by the plugin to authenticate itself with the PayPal API.

Sandbox client secret (6): Here you enter the sandbox REST-API Client-Secret, which the plug-in also uses to authenticate itself with the PayPal API.

Test sandbox API credentials (7): With the help of this button you can test the credentials you have entered. The result of the test is displayed directly in the Save button.

 

Behaviour

Under behaviour you can make basic settings for the plug-in, that are not only valid for the classic PayPal, but also for the Express Checkout and PayPal PLUS.

Merchant location (1): Here you can enter your merchant location.

Payment acquisition (2): This is where you define when the payment is collected - i.e. when it is closed.

Submit cart (3): Here you can choose whether the customer's shopping cart, i.e. the exact positions of the order, are allowed to be transferred to PayPal. If this option is deactivated, only the total amount is transferred.

Your own brand name on PayPal page (4): Here you can set your own brand name for the advertisement on the PayPal payment page.

PayPal landing page (5): Here you can choose whether the PayPal landing page should display the registration form or the login screen.

Submit order number (6): Activate this option if you want to send the order number to PayPal after completion.

Order number prefix (7): Here you can determine which text is appended to the original order number, e.g. myShopSW20001. This option is only available if you have activated the previous option "Submit order number to PayPal".

 

Classic PayPal

By entering the API access data you are using the classic PayPal for your shop. Thus your customers are able to pay for their orders with their PayPal account.

PayPal Express Checkout

The PayPal plug-in also provides the option of express checkout. This means that your customer is not required to register to place an order in the shop. The order will be processed solely by his PayPal account.
 

Configuration

'Pay now' on detail page (1): Here you can specify whether the PayPal Express button is displayed on the item details page.

'Pay now' on cart (2): Here you specify whether the PayPal Express Button should be shown in the shopping cart.

'Pay now' on de Off-Canvas cart (3): If you activate this option, the Express Checkout button will be displayed in the Off-Canvas/Modal shopping cart.

'Pay now' on login page (4): Here you can specify whether the PayPal Express button is displayed on the login page.

'Pay now' on listing pages (5): If you enable this option, the Express Checkout button will be displayed on listing pages.

Button color (6): This option offers you some colors in which the PayPal Express Button can be displayed. Gold, blue, silver, and black are offered.

Button shape (7): Here you determine the shape of the PayPal Express Button. You can choose between round and square.

Submit cart (8): Here you can choose whether the customer's shopping cart, i.e. the exact positions of the order, are allowed to be transferred to PayPal. If this option is deactivated, only the total amount is transferred.

Button locale (9): In this field you can enter different shop languages for the Express Checkout Button. If the field is empty, the sales channel language is used.
It is important that you enter the so-called "locale code" here, such as en_GB. You can find a list of available language codes on the PayPal site.

   

Payment by instalments*

The PayPal plug-in enables you to display a banner for the new installment payment on the item detail page, the (offcanvas) shopping cart and when changing the payment method in the order process. This banner will be displayed on the items that match the criteria for the installment payment.

In order for your customers to use the new installment payment in your shop, they must select the payment method PayPal in the checkout and log in with their PayPal account. Your customers can then check whether the payment method Installment Payment is available.

Further information about PayPal installment payment can be found here.

*Only available in Germany

Configuration

Under payment by instalments you have the option to activate the installment banner. This only works with your Live Client ID (not with the Client ID sandbox).
   

Storefront view

The order process can be carried out as usual if you want to use the payment options of PayPal Plus. PayPal, direct debit, credit card and purchase on account via iFrame are displayed in the payment method selection in the checkout. The prerequisite for this is that the customer has selected PayPal as the payment method in his account.
 

PayPal Checkout with smart payment buttons

If you have selected "Other location" under Behaviour at the merchant location, your shop will offer you the PayPal Checkout with Smart Payment Buttons instead of PayPal PLUS. For the configuration of these Smart Payment Buttons, a new configuration option will appear once you have changed and saved the merchant location.

Configuration

Enable Smart Payment Buttons (1): You can activate or deactivate the Smart Payment Buttons here.


Button locale (2): In this field you can enter different shop languages for the Express Checkout Button. If the field is empty, the sales channel language is used.
It is important that you enter the so-called "locale code" here, such as en_GB. You can find a list of available language codes on the PayPal site.

Activates the alternative payment methods of the Smart Payment Buttons (3): Here you can activate the alternative payment methods like SEPA, credit card, etc.

Button color (4): This option offers you some colors in which the PayPal Express Button can be displayed. Gold, blue, silver, and black are offered.

Button shape (5): Here you determine the shape of the PayPal Express Button. You can choose between round and square.

 

Storefront view

The Smart Payment Buttons are displayed in the checkout instead of the PayPal PLUS payment methods: