Versions Compared

Key

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


Info
titleBraintree Payments

Refer to the 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. 


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.

     

    The User clicks on PayPal to display a PayPal button. 

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

    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. 

    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 pagePayPal Express in cart


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


    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 and Pay in 4 buttons 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).
  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 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

    Label

    PayPal (default)

    Checkout

    Buy Now

    Pay


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

    Message layout

    data-pp-style-layout

    Default: text

     

    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

    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 

     


  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 or the PayPal Pay Later Generic Summary Widget in the location you want it.
     
  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


Ballpark Hours From CV (if opting for CV to complete self config component)


Multiexcerpt
MultiExcerptNameBallpark Hours From CV (if opting for CV to complete self config component)

Contact Commerce Vision


Ballpark Hours From CV (in addition to any self config required)


Multiexcerpt
MultiExcerptNameBallpark Hours From CV (in addition to any self config required)

Contact Commerce Vision


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs

Fees may apply


CMS Category


Multiexcerpt
MultiExcerptNameCMS Category

Payment & Checkout



Related help

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