Setting Up PayPal Checkout
page last edited on 14 July 2020
PayPal Checkout payment method in X-cart is an integration of PayPal Commerce Platform via PayPal addon.
The PayPal Commerce Platform (PPCP) merges the following former PayPal payment solutions:
- PayPal Payments Standard
- PayPal Payments Advanced
- PayPal Payflow Link
- PayPal Express Checkout
- PayPal Credit
- PayPal Partner Hosted with PCI Compliance
With PPCP a best suitable payment method for each buyer is selected dynamically by a special payment button tech. No matter which payment method the buyer selects, all payments are received into one source, allowing for easy withdrawal and consolidated reporting.
- Enabling PayPal Checkout
- Advanced Configuration
Enabling PayPal Checkout
To start accepting payments with PayPal Commerce Platform in your X-Cart store:
Make sure the addon PayPal Checkout is installed and enabled in your X-Cart store.
In your X-Cart store’s Admin area, go to the “Payment methods” page (Store setup > Payment methods) and click Add payment method in the section Online methods:
In the popup box that appears, find the name of the PayPal Checkout payment method and click Add opposite this item: You will be redirected to the PayPal Checkout settings page for further payment configuration.
On the payment setting page you need to connect to your PayPal account or sign up if you don’t have an account with PayPal so far. Select the option that suits you: You will be redirected to PayPal.
On the PayPal side, enter your PayPal email and password to sign in or register a new PayPal account if required: Follow the flow allowing your PayPal account to connect to your X-Cart store.
As a result, your PayPal account should be connected to your X-Cart store with your PayPal account details submitted automatically to the PayPal Checkout settings page in your store Admin area.
Congrats! The payment is enabled and you can start accepting payments with PayPal.
The settings of the PayPal Checkout payment method allow a store admin to maintain the layout of PayPal buttons and badge in the storefront, add extra security to payment processing, set a preferred transaction type in the store and enable the funding methods available for customers.
Defining Preferred Transaction Type
PayPal Checkout payment method allows a merchant to check transaction requests before the actual payment is done. This is possible through the usage of the Transaction type option in the “Additional settings” section of the PayPal Checkout settings page. This section also allows a merchant to set the mode the payment should function in.
If you set the value of the Transaction type option to Auth only, you’ll need to process each transaction manually. This variant is preferred if you need to have an possibility to void orders. If the value is set to Auth and Capture all transactions will be processed automatically.
The Test/Live mode option sets the mode of the payment function. If you want to test payment transactions before making your store live, use the Test value for this option.
Adding Extra Security to Payment Transactions
A store admin can add extra security to the PayPal Checkout payment transactions by enabling the 3D Secure option in the “Additional settings” section of the PayPal Checkout settings page.
When enabled, this allows a merchant to provide Strong Customer Authentication (SCA) required in some EU countries.
It also allows to configure what should be done to transactions with undefined risk factor by 3D Secure. If a merhant wants to continue with the authorization and assume liability, the Authentication bypassed / unavailable liability shift option should be set to Accept. If assuming liability is not an option, the settings should be set to Declined. A buyer will be asked for another card in this case.
Maintaining PayPal Buttons and Badge
PayPal Checkout payment allows a store admin to show or hide the PayPal buy buttons and badge in the storefront and to customize the appearance of the buttons.
Generally, the Buy Now with PayPal button and Now Accepting PayPal badge come enabled in the storefront right after the payment is configured and activated.
The “Buy Now with PayPal” button displays on product list pages (in list view) and product details pages.
The “Now Accepting PayPal” badge displays in the header of every page in the storefront.
To disable the features turn OFF the toggles of the like-named options in the “Additional settings” section of the PayPal Checkout settings page.
To customize the appearance of the PayPal buy buttons use the buttons property chart on the “Customize the PayPal button” page of PayPal Checkout settings:
Enabling Fuding Methods for Customers
A store admin can define whether multiple funding sources should be available for customers or not. By default, all available funding sources are enabled as soon as the PayPal Checkout payment is activated:
When enabled, PayPal automatically determines which additional buttons are appropriate to display for customers at checkout.
However, you can choose to opt-in or out-of displaying specific funding sources if required. For this purpose, use the Funding methods settings on the “Customize the PayPal button” page of PayPal Checkout settings.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.