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 site can offer and manage PayPal checkout and express options within Braintree Payments. This means PayPal payments can be accepted under the Braintree tab during checkout and PayPal Express options can be 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





If enabled, PayPal settings in Braintree Payments settings control the PayPal options your website offers. Your site can include one or all of these PayPal options:

  • PayPal Checkout under 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 Braintree Payments option...

    In the Payment panel during checkout, 'PayPal' displays as an option under Payment Methods.

     Image Modified

    The User clicks on PayPal to display a PayPal button. 
    Image Modified

    The User clicks the PayPal button for the secure PayPal login window to display. 
    Image Modified

    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. 

    Image Modified

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



  • PayPal Express options. These are PayPal payment methods that appear via buttons on the product and/or cart pages. They are 'express' because they allow the customer to submit their order there and then without going through the usual checkout process. Express options include PayPal Checkout and Pay in 4 (PayPal's Buy Now, Pay Later). 

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

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

    PayPal Express in product pageImage ModifiedPayPal Express in cartImage Modified


Configure PayPal 

To set up PayPal with Braintree Payments, your business must have a PayPal merchant account and your PayPal merchant credentials must be 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.
    Image Modified
  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. 
    Image Modified
  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 enabled, PayPal Pay in 4 will not be displayed as a payment option.
    Image Modified
  7. The next few toggles and fields configure PayPal Express, including Pay in 4 and Credit/Debit Card button options in the product and cart pages.

    Info
    titleImportant

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

     

    Image Modified

    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 buttons to display in the cart. (Buttons are displayed based on the selection order 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 page. 

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

  8. To save your settings, click Save

Edit PayPal Express Buttons

The default PayPal Express Image Modifiedand Pay in 4 Image Modifiedbuttons in the product detail and cart pages can be edited separately, in the Product Purchase Detail Widget and Cart Checkout Button Widget


To edit these 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).
    Image Modified
  3. Click Edit.

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

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

    Layout

    Sets whether the PayPal button is vertically or horizontally aligned. 

    Vertical (default)

    Height 

    Specify a height from 25px to 55px. 

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

    Colour

    Gold (default) 

    Other colours: blue, silver, white, black

    Shape

    Rectangle (default) 

    Pill Image Modified

    Label

    PayPal (default) Image Modified

    Checkout Image Modified

    Buy Now Image Modified

    Pay Image Modified

    Layout

    Default: vertical

    Image ModifiedHorizontal

    Image Modified


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

    Message layout

    data-pp-style-layout

    Default: text

    Image Modified 

    Flex - banner 

    Logo type

    data-pp-style-logo-type

    Default: Primary

    Other types: Alternative, None

    Logo position

    data-pp-style-logo-position

    Default: Left

    Other positions: Right, Top

    Text colour

    data-pp-style-text-color

    Black (default)

    Others: white, monochrome, greyscale

    Text size

    data-pp-style-text-size

    Default: 12

    Text align

    data-pp-style-text-align

    Default: Left

    Image Modified

    Options: centre, right

    Style Colour

    data-pp-style-colour

    Background colour of banner when style is flex (banner)

    Default: blue

    Style Ratio

    data-pp-style-ratio

    Shape and size of banner when style is flex (banner)

    Default: 1x1 

    Image Modified

     


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