Page History

Step by Step Guide

1. Configure General Settings 

To configure Braintree Payment Settings

:

1. Navigate to Settings → Payment & Checkout → Braintree Payment.
   Image Modified
2. If the Available in CMS toggle is not enabled, toggle it ON. 
   
   
3. Click Configure.
   

1. 
   
2. In Braintree Payment Settings, configure General Settings

1. . 
     
   
   1. To enable Braintree for all Users on your site, toggle ON Enable Braintree Payment. TIP - Leave this global toggle off and add Role Overrides

1. 1. to

1. 1. only offer Braintree to specific roles, e.g., B2C customers. 
      
      
   2. If your site will use Braintree Payments only for credit card and/or PayPal transactions, toggle on Show Braintree Payment Options Only. This will disable other credit card gateways and turn off the separate PayPal feature.
      Image Added
      
      

   3. In Mode,

1. 1. select 'Sandbox' if

1. 1. testing the

1. 1. Stage site, or 'Production'

1. 1. if the live site. 
      

      Info
      The sandbox is an entirely separate environment from your production account.  Your sandbox login information, merchant ID, and API keys will be different. Nothing created in the

1. 1. Sandbox (e.g. processing options, recurring billing settings) will transfer to

1. 1. Production.

      
      

   2. Enter credentials for either 'Sandbox' or 'Production'. You will need the following from your Braintree account:
      - Merchant ID - this is the default ID used to verify the account. If your business has several Merchant Account IDs and you want to specify one of them, enter it in the Merchant Account ID field instead of here.  
      - Public Key 
      - Private Key 
      - Merchant Account ID - leave blank if the

1. 1. 'Merchant ID' is to be used.
      

1. 1. 
      

2. To allow Users to

1. delete a saved (vaulted) payment, toggle ON Allow Vault Management. When this setting is enabled, in the Payments panel during checkout, there is an Edit link

1. on the top right side.  
   Image Modified  
   
   When the User clicks on Edit, the delete

1. icon displays next to each payment. The User can click on it to remove the saved payment.  
   Image Modified    
   If the toggle is OFF, the Edit link is not displayed. To delete a vaulted payment, Users will need to contact your customer service and have the saved payment

1. deleted in your Braintree account.
   
   

2. If the vaulted payment is to be preselected

1. during checkout, toggle ON Preselect Vaulted Payment Method.

1. The preselected payment is foregrounded and has a tick Image Modifiednext to it. If this toggle is OFF, the last

1. entered payment will be preselected.
   Image Modified
   
   

2. If

1. the

1. nominated default payment option (set in the Braintree account) is to be displayed

1. at the top of the list, toggle ON Show Default Payment Method First.
   
   

   Tip
   title To flag as default
   To make a payment option default, in your Braintree account, go to the Vault and find the User. Click on the payment option and click Edit. Tick the Default Payment Method for Customer? checkbox.

   
   

2. Configure payment options 

The next step is to configure

the payment

options your site

offers. Each one can be enabled or disabled at any time

. Note that options enabled here must also be turned on in your Braintree account. 

All enabled Braintree payment methods will display under a common Payment Methods tab during checkout.

TIP -

You can change the tab name 'Payment Methods' in the Checkout Payments Options Widget.

PayPal Express and Pay in 4 buttons can also be added to the product and cart pages. 

Image Added

See the step-by-step guide for each payment method: 

Credit Card Settings

Configure Braintree Credit Card Settings

PayPal Settings

Configure Braintree PayPal Settings

Google Pay Settings

Configure Braintree Google Pay Settings

Apple Pay Settings

Configure Apple Pay Settings

3. Fraud Protection Settings for Order Payment

Braintree Payments has three fraud protection modes

, and one must be selected. Information provided here is limited to setting up an option for your website. Details about fraud protection options are available from the Braintree website. (NOTE - Advanced and Kount are options that incur additional fees.)

In addition, 3D Secure, which provides an extra layer of security by prompting a User to authenticate card ownership by entering a PIN, can be enabled.

1. In Braintree Payment Settings, scroll down to the Fraud Protection Settings for Order Payment section.
   
   
2. In Fraud Protection Mode, select Basic, Advanced or Kount.

1. NOTE - The mode enabled her must be the same as the mode enabled in your Braintree account.
   Basic - all fraud protection is handled by Braintree and no further configuration is required here.
   
   
   
2. (For 'Advanced' or 'Knout' only.) In Treat Decision 'Not Evaluated' As, select 'Review' or 'Approve'. 
   Review: the transaction with this status is treated as suspicious and put on hold subject to further verification
   Approve: the transaction with this status is treated as a successful one and the order is released.  
   
   
3. (For 'Knout' only.) In Treat Decision 'Escalate' As, select 'Review' or 'Approve'.
   Review: the transaction with this status is treated as suspicious and put on hold subject to further verification
   Approve: the transaction with this status is treated as a successful one and the order is released
   
   

4. To use 3D Secure, toggle ON Enable 3D Secure. NOTE - This feature adds another layer of security for payments that use credit cards, including Google Pay. It is applicable only to cardholders who have enrolled in 3D Secure with their issuer.

1.  

   Expand
   title Click here to know more about 3D Secure...
   During the checkout process, if the cardholder is enrolled in 3D Secure, the issuing bank will decide whether the cardholder's identity can be verified using data supplied regarding the cardholder and their device, or if an additional authentication process is necessary. If additional authentication is necessary, Braintree will begin a process provided by the issuing bank to verify the cardholder’s identity via SMS one-time passcode, the issuing bank's mobile app, biometric methods, or other means. 3D Secure can shift liability for fraud-related chargebacks from the merchant to the card issuer. For example, if the issuer does not participate in 3D Secure but the card brand supports this extra protection (i.e. Visa or Mastercard), the liability for fraud-related chargebacks will shift to the issuer. NOTE - 3D Secure does not shift liability for all fraudulent chargebacks. You can determine whether or not liability shift occurred by the 3D Secure status code returned for the authentication.

   
   Example of 3D Secure popup:
   Image Added
   If the credit card payment passes 3D Secure, the order will be completed. If the payment is rejected by 3D Secure, the User will see a 'Rejected by Gateway' popup error message on your site:
   
   Image Added 
   This status is also recorded in the Braintree account. 
   Image Added
   
   
   

2. (For use with 3D Secure only). The 3D Secure Review Status List provides all 3D Secure statuses that will not reject the order if 3D is not required. it allows you to put such orders on hold for further verification. For instance, 'authenticate_attempt_successful' means that the card brand passed the attempt because the issuer's authentication server was unavailable. You can add one or more such statuses. NOTE - For a list of what each of the statuses mean, refer to the Braintree website.
   
   Click on the list, then click to select all required statuses. These statuses will populate the field.  
   Image Added 
   For cards that cannot be authenticated and the status is on this list, payment will not be processed and the User will see this message: 
   Image Added  

Additional Information

Related help