Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titleBraintree Payments

See documentation on Braintree Payments for other help topics. 


Your ecommerce site can offer and manage PayPal checkout and express options within Braintree Payments. With this option, PayPal payments are available under the Braintree tab during checkout and PayPal Express is controlled through Braintree settings.  All PayPal transactions processed through the Braintree gateway will be integrated in your Braintree Control Panel.


NOTE - You will still need to establish a PayPal merchant account separately as payment processing fees will be charged by PayPal. Braintree does not charge fees for handling PayPal transactions. 




Panel

On this page:

Table of Contents
minLevel2


PayPal in Braintree Payments

When PayPal is controlled in Braintree Payments settings, one or all of these PayPal options can be enabled on your site:

  • PayPal under the Braintree Payments 'Payment Methods' tab during the checkout process.  NOTE - For PayPal checkout, vaulting can be enabled to save the PayPal account details for future use without requiring re-authenticating with PayPal. Vaulting is not compatible with Pay in 4. If it is enabled, once logged into PayPal, Pay in 4 will not be offered as an option.  

    Expand
    titleClick here to view PayPal under Braintree Payments..

    1, In the Payment panel during checkout, PayPal displays as a payment option under Braintree's Payment Methods tab.

     

    2. When the user selects PayPal, the PayPal button is displayed. 

    3. The user clicks the PayPal button for the secure PayPal login window. 

    4. The user logs into their PayPal account and selects from available payment options. After payment selection has been approved, they are returned to your website. The PayPal account with login ID is displayed. 

    5. The user clicks Process Payment to complete payment. If 'Allow Vault PayPal' is enabled, a successful PayPal account will be vaulted ready for future purchases.  



  • PayPal Express options. These PayPal payment methods are accessed via buttons on the product and cart pages. They are 'express' because the customer can log in to PayPal immediately to pay without adding to cart and going through the usual checkout process steps. Choose one or both Express options:  PayPal Checkout, Pay in 4 (PayPal's Buy Now, Pay Later). 

    NOTE - Adding PayPal Express checkout through Braintree settings disables the use of separate PayPal Express settings

    Expand
    titleClick here to view PayPal Express in product and cart pages...

    PayPal Express in product pagePayPal Express in cart


Configure PayPal 

Your business must have a PayPal merchant account and your PayPal merchant credentials must have been added in your Braintree account.

Info
titlePayPal Testing

Please consult Braintree documentation about testing your PayPal-Braintree integration.  


To configure Braintree PayPal settings on your website:

  1. Navigate to SettingsPayment & CheckoutBraintree Payment.
  2. If the Available in CMS toggle is not enabled, toggle it ON. 

  3. Click Configure.

  4. Scroll down to PayPal Settings.

  5. In the PayPal settings section, toggle ON EnablePayPal. This enables Braintree PayPal on your site. 

    When Braintree PayPal is enabled, separate PayPal Express settings are disabled. 

    Expand
    titleCheck to confirm PayPal Express is controlled by Braintree...

    Navigate to SettingsFeature ManagementPayment & CheckoutPayPal Express. The Use Braintree For PayPal Express toggle is ON.


  6. Allow Vault PayPal: Toggle ON to automatically save a successful PayPal payment for future use. IMPORTANT- PayPal vaulting is incompatible with offering Pay in 4 during checkout. If this toggle is enabled, PayPal Pay in 4 will not be displayed as a payment option when the user is logged into their PayPal account.
  7. The next few toggles and fields configure PayPal Express, including Pay in 4 and Credit/Debit Card button options in  options in the product and cart pages.

    info

    titleImportant

    To use Express options in Braintree, Paypal Express must be enabled for the CMS. 
    Image Removed


     

    1. Enable PayPal Express: toggle ON for PayPal Express options to be controlled by Braintree Payments. NOTE - This disables non-Braintree PayPal Express on your site.

    2. Display PayPal Express On Cart: toggle ON to display PayPal buttons in the cart.

    3. Cart Page PayPal Express Buttons: click in the field and select the PayPal payment to select which Express buttons to display in the cart. (Buttons are displayed based on in the order of selection order entered here.)
      PayPal: PayPal button
      Paylater: Pay in 4 button

    4. Display PayPal Express On Product Detail: toggle ON to display PayPal buttons in the product pagepages

    5. Product Page PayPal Express Buttons: click in the field and select the PayPal payment to select which Express buttons to display in the cartproduct pages. (Buttons are displayed based on in the order of selection order entered here.)
      PayPal: PayPal button
      Paylater: Pay in 4 button

  8. To save your settings, click Save

Edit PayPal Express Buttons

The default PayPal Express buttons are: and Pay in 4 Image Removedbuttons Image Added. You can change how they look in the product detail and cart pages can be edited separately, in the Product Purchase Detail Widget and the Cart Checkout Button Widget


To edit these Express buttons:

  1. Navigate to ContentPages & Templates.

  2. Use the Search tool to find the template with the Product Purchase Detail Widget (the Product Detail template) or the Cart Checkout Button Widget (CheckoutCart template).
  3. Click Edit.

  4. Find the Widget and click Edit.
  5. Click the Braintree tab.

  6. To change the text and button style of the PayPal Express Button Options, click Edit.


    Layout

    Sets

    whether

    the PayPal button

    is

    as vertically or horizontally aligned. 

    Vertical (default)

    Default: vertical Image Added

    Option: horizontal Image Added

    Height 

    Specify a height from 25px to 55px. 

    NOTE - For To use the default height (defaults from set by Braintree), do not use add this setting. 

    Colour

    Gold (default) 

    Other coloursDefault: Gold 

    Options: blue, silver, white, black

    Shape

    Rectangle (default) 

    Pill Default: rectangle 

    Option: pill

    Label

    PayPal (default) Image Removed

    Default: PayPal    Image Added

    Options:

    PayPal Checkout

    PayPal Buy Now Now 

    Pay with PayPal   

    Layout

    Default: vertical

    Image RemovedHorizontal

    Image Removed


  7. The default tag line for Pay in 4 is: Image AddedTo change the text and button style of the Pay in 4 messagingit, click 'PayPal Pay Later Messaging Options' Edit. Default: Image Removed  

    Message layout

    Layout

    data-pp-style-layout

    Default: text

    Image Modified 

    Option: Flex - displays a banner 

    Logo type

    data-pp-style-logo-type

    Default:

    Primary

    primary

    Other types

    Options:

    Alternative

    alternative,

     None

    none

    Logo position

    data-pp-style-logo-position

    Default:

    Left

    left

    Other positions

    Options:

    Right

    right,

     TopOthers

    top

    Text colour

    data-pp-style-text-color

    Black (default)

    Default: black

    Options: white, monochrome, greyscale

    Text size

    data-pp-style-text-size

    Default: 12

    Options: various font sizes

    Text align

    data-pp-style-text-align

    Default:

    Left

    left

    Image Modified

    Options: centre, right

    Style

    Banner Colour

    data-pp-style-colour

    Background colour of banner

    when style is flex (banner

    (layout: flex)

    Default: blue

    Banner Style Ratio

    data-pp-style-ratio

    Shape and size of banner

    when style is flex (banner

    (layout: flex)

    Default: 1x1 

    Image Modified

     


  8. To hide the PayPal Pay in 4 messagetag line, toggle ON Force Hide Pay Later Message.  TIP -  To add a Pay in 4 message separately, you can always use the PayPal Pay Later Cart Summary Widget (for Cart) and the PayPal Pay Later Checkout Summary Widget (for Checkout pages) where you want them. You can also add the

    Why would I want to hide the tag line?
    This tag line is not aligned with the Pay in 4 button. It displays after the Express buttons. So it may not be located where you would like it to be. You can always add a Pay in 4 tag line separately where you want it using the PayPal Pay Later Generic Summary Widget on any page or template.
     
  9. To save these settings, Click Save.


Additional Information

 

Multiexcerpt
hiddentrue
MultiExcerptNameFeature Title

 --



Minimum Version Requirements


Multiexcerpt
MultiExcerptNameMinimum Version Requirements

4.31


Prerequisites


Multiexcerpt
MultiExcerptNamePre reqs

Braintree Account, third party payment accounts


Self Configurable


Multiexcerpt
MultiExcerptNameSelf Configurable

Yes


Business Function


Multiexcerpt
MultiExcerptNameBusiness Function

Payment Types


BPD Only?


Multiexcerpt
MultiExcerptNameBPD Only

Yes


B2B/B2C/Both


Multiexcerpt
MultiExcerptNameB2B/B2C/Both
Both


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs

Fees may apply



Related help

Content by Label
showLabelsfalse
showSpacefalse
excludeCurrenttrue
cqllabel = "payment" and title ~ "Braintree"

Content by Label
showLabelsfalse
showSpacefalse
titleRelated widgets
excludeCurrenttrue
cqllabel = "widget" and title ~ "PayPal summary"