Braintree 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.
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.
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.
PayPal Testing
Please consult Braintree documentation about testing your PayPal-Braintree integration.
To configure Braintree PayPal settings on your website:
- Navigate to Settings → Payment & Checkout → Braintree Payment.
- If the Available in CMS toggle is not enabled, toggle it ON.
- Click Configure.
- Scroll down to PayPal Settings.
- In the PayPal settings section, toggle ON Enable PayPal. This enables Braintree PayPal on your site.
- 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.
- 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.
- 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.
- Display PayPal Express On Cart: toggle ON to display PayPal buttons in the cart.
- 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- Display PayPal Express On Product Detail: toggle ON to display PayPal buttons in the product page.
- 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- 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:
- Navigate to Content → Pages & Templates.
- 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).
- Click Edit.
- Find the Widget and click Edit.
Click the Braintree tab.
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
Layout Default: vertical
Horizontal
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
- 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.
- To save these settings, Click Save.
Additional Information
| Minimum Version Requirements |
|
|---|---|
| Prerequisites |
|
| Self Configurable |
|
| Business Function |
|
| BPD Only? |
|
| B2B/B2C/Both |
|
| Ballpark Hours From CV (if opting for CV to complete self config component) |
|
| Ballpark Hours From CV (in addition to any self config required) |
|
| Third Party Costs |
|
| CMS Category |
|
Related help
