PayPal (SaaS)

The PayPal extension offers you the possibility to provide your customers with the common PayPal payment methods.

Installation

An installation is not necessary, because the extension is already available in your SaaS store under Settings > Shop > Payment methods. You only need to activate this extension and link it to your PayPal account.

Linking to a PayPal account

In order to use the PayPal extension in your store, you have to link it to your PayPal account after activation. To do this, click on Connect PayPal account (1). Afterwards you have to enter the login credentials of your PayPal account in a modal window.

PayPal test mode

With the PayPal Test mode switch (2) you can test purchases via PayPal. 
If you activate the test mode, your store will be connected to a general sandbox account. You can make purchases in the checkout with PayPal.
These orders will be listed in your order overview, but since the payments are made via the sandbox account, these orders will not appear in your PayPal merchant account.

The Test mode is for evaluation purposes only. It should not be used in production environments.

Change or disconnect PayPal account

After you have entered your login credentials and connected your account, the view under PayPal will change. Here you can see the status "Connected" and the account name (email address).

If you want to change the PayPal account, you can do this by clicking on Change PayPal account (1).

Only one PayPal account can be linked in this extension at a time.

If you don't want to use your PayPal account anymore, you can disconnect it from the extension by clicking Disconnect PayPal account (2).

General configuration

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

Sales channels

In this drop-down menu you can select for which of your sales channels the settings should be made. You can choose between All sales channels or individual sales channels.

With the button Set PayPal as default you can activate PayPal in the selected sales channel and set it as default payment method.

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".

Excluded products (8): Here, products can be excluded from being paid for via PayPal payment methods. 
Excluded dynamic product groups (9): Here, entire dynamic product groups can be excluded from being paid for via PayPal payment methods.

Vaulting (One-time Checkout)

With the one-time checkout, you can enable your customers to save their PayPal data permanently in the future.

This function is currently in beta phase.

Credit- or debit card

PayPal uses the credit or debit card to check whether strong customer authentication via 3D Secure is required. If the option Block payments from non-3DS countries is activated, the corresponding card cannot be used for payment if a 3DS check is not possible.
3D Secure is a protocol to ensure safer payment with credit- and debit cards.

Pay upon invoice

With the Pay upon invoice, your customers can place the order as a purchase on account. PayPal settles the invoice amount to you as the store operator, and the customer must settle the invoice as a transfer to PayPal / Ratepay.

Configuration

This field can be used to implement additional information in customer e-mails for the payment method purchase on account, for example, notes on payment.

Storefront presentation

PayPal Express Checkout

The PayPal extension also offers the possibility of express checkout. With this option, your customer does not have to register in the shop for his order. The order will be processed solely through his PayPal account.

'Direct to PayPal' on detail page (1): Here, you can define whether the PayPal Express Button is shown on the item detail page.

'Direct to PayPal' in the shopping cart (2): Here, you can define if the PayPal Express Button should be shown in the shopping cart.

'Direct to PayPal' in the Off-Canvas shopping cart (3): If you activate this option, the Express Checkout Button will be shown in the Off-Canvas/Modal shopping cart.

'Direct to PayPal' on the login page (4): Here, you can determine whether the PayPal Express Checkout Button is offered on the login page.

'Direct to PayPal' on listing pages (5): If you activate 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 define the shape of the PayPal Express Button. You can choose between round and square.

Button language (8): In this field, you can enter different shop languages for the Express Checkout button. If the field is empty, the sales channel language will be used.
It is important that you enter the so-called "locale code" here, such as en_GB. A list of available language codes can be found on the PayPal site. You can also open the page by clicking on the link "here".

Display 'Pay Later' button next to the 'PayPal Checkout' button (9): Here, you can activate the option, that the 'Pay Later' button will be displayed next to and with the same design as the 'PayPal Checkout' button.

Smart Payment Buttons

If you have selected "Other merchant location" under Behavior for the merchant location, the Smart Payment buttons will be displayed in the checkout in your store. For the configuration of these smart payment buttons, a new configuration option will be displayed as soon as you have changed the merchant location.

Configuration

Enable the alternative payment methods for the Smart Payment Buttons (1): Enable the alternative payment methods for the Smart Payment Buttons.
Display Pay Later as a separate button (2): If the button is also, a "PayPal Pay Later" button is inserted, which leads the customer directly to the PayPal option to pay the amount after 30 days.  
Button color (3): This option offers you some colors where the PayPal Express button can be displayed. Gold, blue, silver, and black are offered.
Button shape (4): Here, you can define the shape of the PayPal Express button. You can choose between round and square.
Button language (5): In this field, you can enter different store languages for the Express Checkout button. If the field is empty, the sales channel language will be 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 page. You can also open the page by clicking on the link "here".