The PayPal Checkout payment method settings 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 Types

The PayPal Checkout payment method allows a merchant to check transaction requests before payment. It is possible by using 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 of payment functioning.

The possible values of the "Transaction type" option are:

  • Auth only: Select this value to process each transaction manually. Use this variant if you need to have the possibility to void orders.

  • Auth and Capture: Select this value to enable automatic transaction processing.

The "Test/Live mode" option defines the operating mode of the payment function. Set the operation mode to Test if you want to test payment transactions before making your store live.

Adding Extra Security to Payment Transactions

A store admin can add extra security to the PayPal Checkout payment transactions by enabling the 3D Secure toggle in the Additional Settings section of the PayPal Checkout settings page.

This option allows a merchant to provide Strong Customer Authentication (SCA) required in some EU countries.

NOTE: In X-Cart 5.4.x, it also allows configuring what should be done to transactions with undefined risk factors by 3D Secure. For example, if a merchant wants to continue with the authorization and assume liability, a store admin should set the "Authentication bypassed / unavailable liability shift" option to Accept. If accepting liability is not an option, select the Decline value. The system will ask a buyer for another card in this case.


Maintaining PayPal Buttons and Badge

PayPal Checkout payment allows a store admin to show or hide the PayPal buttons and badge in the storefront and customize the controls' appearance.

Generally, the "Buy Now with PayPal" button and the "Now Accepting PayPal" badge are enabled in the storefront after the payment is configured and activated.

The "Buy Now with PayPal" button is displayed on product list pages (in list view) and product details pages.


The "Now Accepting PayPal" badge is displayed in the header of 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 buttons, use the property chart on the "Customize the PayPal button" tab of the PayPal Checkout settings page:

Disabling Funding Methods for Customers

A store admin can set whether customers should see multiple PayPal payment options. By default, all available funding sources come enabled as soon as the PayPal Checkout payment is activated. After that, PayPal automatically determines which additional buttons are appropriate to display for customers at checkout.

However, you can opt in or out of showing specific funding sources if necessary. For this purpose, use the "Disable funding methods" drop-down in the Additional Settings section of the PayPal Checkout settings page. Select here all methods that should not display to customers at checkout.

Related pages:

Did this answer your question?