Braintree

Overview

The Braintree Payment Gateway provides merchants with a way to accept credit cards in a PCI-compliant manner without storing credit card information locally or sending customers to another website to complete their transactions.

Getting Started

Follow the steps below to get started with Braintree.

If you do not already have an Braintree account, contact Braintree.

Use the account information for your new account to fill in the fields in the ShopSite Braintree Settings screen, as explained below.

Begin processing transactions.

Setup

From the Commerce Setup screen, select Payment, then scroll down and select the radio button for Braintree labelled Braintree Payment Gateway, then click Configure Processor. You will see a screen with the following fields:

Host

Choose either Test Server or Live Server. By selecting the test server, you can test your payment gateway settings before switching over to the live server. Select the Live Server to start accepting credit cards.

Merchant ID for API

Enter the Merchant ID for API provided by Braintree.

Merchant public key

Enter the Merchant public key provided by Braintree.

Merchant private key

Enter the Merchant private key provided by Braintree.

Order Transaction Type

Specify the type of transaction that you want ShopSite to process when a customer places an order. For most situations, you should leave this set to Authorize Only. If your store sells digital download products, you may want to set this to Authorize and Capture (Sale) to ensure that the funds are actually captured before customers are given access to the online products.

Authorize Only: This is the normal transaction method for ShopSite. When a customer clicks "Submit This Order," ShopSite forwards the transaction to Braintree for authorization, the transaction is authorized, and ShopSite is notified of the authorization. A "hold" for the amount of the purchase is placed on the customer's credit card, but the funds are not "captured" until the merchant goes to the Orders screen in ShopSite and clicks Bill Orders.
Authorize and Capture (Sale): This method authorizes a transaction and captures funds all at once. ShopSite forwars a transaction to Braintree for approval, the transaction is approved, ShopSite is notified of the approval, and the transaction automatically settles at the end of the business day without any further action by the merchant. If you select this transaction type, you will not be able to use the Bill Order button on the Orders screen to capture funds because they are captured at the time of the order.

Store transactions in the Braintree Vault

Specify whether or not you want Braintree to store transactions in the Braintree Vault. This will allow you to view the stored transactions at a later time by logging in to your Braintree acount and visiting the Braintree Vault.

Display CVV2 Entry Box

Check this box to provide customers with the option to provide the Card Verification Value (CVV2) for the credit card they wish to use. More information on CVV2 can be found here.

Require CVV2 Entry

Check this box to require customers to enter the Card Verification Value (CVV2) for the credit card they wish to use. More information on CVV2 can be found here.

Display Error Details

Check this box only when setting up a new Braintree account and making test purchases. If there are any problems with the transactions, the customer will see details about the error. Turn this option off when you are ready to accept real transactions.

Credit Cards

Supported cards and other payment types

Select which credit cards you want to accept payments from. If you are using a real-time payment gateway, you should check to see what cards your gateway accepts, and what the fees for those cards are. Check the box beside the card name to accept payment from that card. You can select any (or all) of the following:

Visa
MasterCard
Discover
American Express
Diner's Club/Carte Blanche

CVV2 Help Text

Enter the text to be used for the CVV2 Help Link. If your credit card processor is configured to include a CVV2 field with the payment information, this text will be displayed as a link beside the field.

CVV2 Help URL

This is the URL to be used for the CVV2 Help Link. When a customer clicks the link beside the CVV2 field, a new window will open to this URL. You can use the default URL or you can create your own page explaining what a CVV2 is and where to find it on a credit card.

Fill in the proper values and click Save Changes.

ShopSite Help and Resource Center
Last updated: February 18, 2014
Give Feedback

ShopSite Shopping Cart Software