Versions Compared

Old Version 32

changes.mady.by.user Documenter

Saved on

compared with

New Version Current

changes.mady.by.user Documenter

Saved on

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 Customer Self Service site can offer and manage PayPal checkout and express options within through Braintree Payments. With this option, PayPal payments are payment is available under on the Braintree tab during checkout and PayPal Express is controlled through Braintree settings.   All PayPal transactions processed through the Braintree gateway will be integrated and viewable 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


Braintree PayPal

Settings in

These Braintree

Payments

PayPal will now be controlled in Braintree Payments settings. Your site can include one or all of these PayPal optionsoptions can be enabled on your site:

  • PayPal Checkout under on the Braintree Payments 'Payment Methods' tab during the checkout process.  Vaulting can be enabled to save the PayPal account details for future use without requiring your customer to be present during the transaction or to re-authenticate with PayPal. NOTE - Vaulting is not compatible with Pay in 4. If it is enabled, Pay in 4 will not display to the customer.  

    Expand
    titleClick here to view PayPal as a on the Braintree Payments optiontab...

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

     Image RemovedThe User clicks on PayPal to display a PayPal buttonImage Added

    2.  When PayPal is selected, the PayPal button is displayed. 

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

    4. The User 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 user clicks Process Payment to complete payment for the order. If 'Allow Vault PayPal' is enabled in Settings, a successful PayPal account will be vaulted ready for future purchases.  .  NOTE - If vaulting is on, Pay in 4 will not be offered as an option to a logged in registered user.  


  • PayPal Express options. These are PayPal payment methods that appear via accessed through buttons on the product and /or cart pages. They are 'express' because they allow the customer to submit their order there and then without 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 include :  PayPal Checkout and , Pay in 4 (PayPal's Buy Now, Pay Later). 

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

    Expand
    titleClick here to view PayPal Express in product and cart on the Product Details and Cart pages...

    PayPal Express in product pageImage RemovedPayPal Express in cartImage RemovedImage AddedImage Added


Configure

PayPal To set up PayPal with Braintree Payments, your business must

PayPal Settings

Before configuring PayPal settings, ensure you have a PayPal merchant account and your PayPal merchant credentials must be have been added in your Braintree account.

Info
titlePayPal Testing

Please consult Braintree documentation about For help on testing your PayPal- Braintree Paypal integration, see documentation from Braintree.  


To configure Braintree PayPal settings on your website:

  1. Navigate In the CMS, go to Settings → Payment & Checkout → Braintree 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

    To enable Braintree PayPal on your site, toggle ON EnablePayPal.

    This enables Braintree PayPal on your site. 
    Image Removed

      
    Image Added
    When Braintree PayPal is enabled, non-Braintree PayPal Express settings are disabled. 

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

    Navigate to Settings → Feature Management → Payment & Checkout → PayPal Express. The Use Braintree For PayPal Express toggle is ON.

    Image Added


  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 . If this toggle is through the checkout process for logged in users. When enabled, PayPal Pay in 4 will not be displayed as a payment option to the user in their PayPal account. It will still be available for guest users.

  7. The next few toggles and fields configure set PayPal Express, including Pay in 4 and Credit/Debit Card button options in options for 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 any non-Braintree PayPal Express settings on your site.

    2. Display PayPal Express On Cart: toggle ON to display PayPal Express buttons in on the cartCart page.

    3. Cart Page PayPal Express Buttons: to select what Express buttons display, click in the field

      and

      , then select the

      PayPal payment buttons to display in the cart

      button(s). (Buttons

      are displayed based on

      display on the page in the selection order entered here.)
      PayPal: PayPal button
      Paylater: Pay in 4 button

      Tip
      titleWhat is the difference between the buttons?

      Allows quicker access to a payment option when user logs into their account

      PayPal button - default payment option the user previously selected displays first.

      Pay in 4 button - Pay in 4 is offered first.  



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

    5. Product Page PayPal Express Buttons: to select what Express buttons display, click in the field and , then select the PayPal payment buttons to display in the cartbutton(s). (Buttons are displayed based on display on the page in the selection order entered here.)
      PayPal: PayPal button
      Paylater: Pay in 4 button

  8. To save your settings, click Save. 
Edit


Customise PayPal Express

Buttons

buttons

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


To edit these customise Express buttons:

  1. Navigate Go to Content → Pages & 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 (Checkout → Cart template). 
  3. Click Edit.

  4. Find the Widget and click Edit next to it.

  5. Click the Braintree tab.

  6. Sets whether the PayPal button is vertically or horizontally aligned. 

    Vertical (default)

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

    Layout


    Info
    titleButton Width

    By default, the button adapts to the size of its container element. Adjust the width of the container element to change the button width.



  7. Customise as needed.

Button Customisation Options

PayPal Button options
Layout

For multiple buttons, select to align them vertically or horizontally. 

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

Default: Gold (

default) Other colours: bluePill

PayPal-recommended as the brand's most recognised button colour). 

Options: blue (recommended first alternative), silver, white, black

Shape

Rectangle (default) 

Default: rectangle (PayPal-recommended)

Image Added

Option: pill

Image Modified

Label

Default: PayPal (

default

recommended)

Image Modified

Options:

PayPal Checkout

Image Modified

PayPal Buy

Now

Now 

Image Modified

Pay with PayPal 

Image Modified

Layout

Default: vertical

Image RemovedHorizontal

Image Removed

To change the text and button style of the Pay in 4 messaging, click Edit. Default: Image Removed 
Image Removed

Message layout


Add/Edit Pay in 4 messaging


There are two Pay in 4 messaging versions:

  • generic - standard messaging suitable and available for any page or template. Just add the PayPal Pay Later Generic Summary Widget to a page. A generic message can also be added in the Braintree Payments space on the Checkout page. Just toggle on the setting in the Checkout Payment Options Widget. (NOTE - Messaging is hidden for registered users when vaulting is on.)
    Image Added
  • with instalment amount - messaging includes the actual amount of each instalment based on the product price or cart total on the page at the time. This is automatically enabled on the product detail page, cart page and the cart summary popup. To disable the messaging, just toggle off the Pay Later message under the Braintree tab in the relevant widget: 


Multiexcerpt
MultiExcerptNamePayin4

To customise the messaging style, in the widget:

  1. Click Edit next to PayPal Pay Later Messaging Options.  
    Image Added
    NOTE - To access PayPal Pay Later Messaging Options in widgets with the calculated payment messaging or in the Checkout Payment Options Widget, select the Braintree tab.

    Image Added


  2. In the Name dropdown, select the option to customise.
    Image Added

  3. In Value, select the value for the option.
    Image Added
  4. Click Add.

  5. Repeat steps 2-4 for each option you want to set.

  6. To save, click Apply.
    Image Added


Messaging Customisation Options

Layout

data-pp-style-layout

Sets the messaging as text only or in a banner

Default: text

Image Modified 

Option: Flex - displays a flexible display banner 

Image Added

NOTE - If the Layout attribute is not added, 'text' will default.

Tip

The text layout is ideal for placement under product and cart prices. The flexible display banner is ideal for placement above the fold on your home and product category pages. It is designed to be eye-catching.


Logo type

data-pp-style-logo-type

Sets the logo type.

Default:

Primary

primary

Other types: Alternative, None

Options: alternative, inline, none

Image Added

Logo position

data-pp-style-logo-position

Sets the position of the PayPal logo in the message

Default:

Left

left

Other positions

Options:

Right

right,

 Top

top

Image Added

Text colour

data-pp-style-text-color

Black (default)

Others

Sets the text and logo colour of the message.

Default: black

Options: white, monochrome,

greyscale

grayscale

Image Added

Text size

data-pp-style-text-size

Sets the size of the message text.

Default: 12

Options: 10, 11, 13, 14, 15, 16

Image Added

Text align

data-pp-style-text-align

Sets the direction the text aligns for text layout messages.  

Default:

Left

left

Image Removed

Options: centre, right

Image Added

Style

Banner Colour

data-pp-style-colour

Background colour of banner when style is flex (banner

Sets the banner colour (layout: flex)

Default: Blue - blue background, white text, white logo 

OptionsBlack - black background, white text, white logo

Image Added

White - white background with blue text, coloured logo and blue border

Image Added

Gray - gray background, blue text, coloured logo

Image Added

Monochrome - white background, black text, black logo 

Image Added

Grayscale - white background, black text, grayscale logo 

Image Added


Banner Style Ratio

data-pp-style-ratio

Shape

Sets the shape and size of

banner when style is flex (banner

the banner message (layout: flex)

Default:

1x1 

Image Removed

Ratio 1x1. Flexes between 120px and 300px wide. 

Image Added

Options:

Ratio 1x4. 160px wide.

Image Added

Ratio 8x1. Flexes between 250px and 768px wide.

Image Added

Ratio 20x1. Flexes between 250px and 1169px wide.

Image Added


 
     

  1. To hide the PayPal Pay in 4 message, 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


  1. Why would I want to hide the messaging?
    This messaging is not controlled by where the Pay in 4 button is located. It simply displays after the Express buttons. So it may not display where you would like it to be. You can always add Pay in 4 messaging where you want it by adding the PayPal Pay Later Generic Summary Widget on any page or template.
     
  2. To save
these settings
  1. changes, 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
excludeCurrenttrue
cqllabel = "paypal" and title ~ "Pay in 4"

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