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.

Note:

You must have PHP version 5.4 or greater enabled on your server for Braintree v.zero to work. When you come to this screen in the back office, you will see an error similar to the following if ShopSite can't detect that PHP is enabled: "There was an error verifying the secure certificate for the shopping cart URL: https://www.store.com/cgi-bin/sc/scphp/v.zero/check.php"

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.

Setup

From the Commerce Setup screen, select Payment, verify that the Credit Cards check box is set, then select Braintree v.zero from the drop-down list under Credit Cards, and click Configure. You will see a screen with the following fields:

Authorize ShopSite to connect with Braintree

Click the "Connect with Braintree" button to open a new window that navigates to a sign-up page for Braintree. Follow the steps provided. If you already have an account with Braintree, click the login link at the bottom of the page. The last step grants ShopSite access to your account for the purposes of managing transactions and customers. Click the Agree and Return to ShopSite button.

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

This read-only field is populated automatically when ShopSite completes connecting with Braintree. It displays the merchant ID assigned to your account.

API access token

This read-only field is populated automatically when ShopSite completes connecting with Braintree. It displays the API access token assigned to your account.

Master Merchant Account ID (optional)

If you have a single merchant account, it is not necessary to specify a merchant account ID. If you have multiple merchant accounts and choose not to specify the merchant account ID, all requests will process through your default merchant account. Refer to this Braintree Article for more information.

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.

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.

Fill in the proper values and click Save and Enable.

ShopSite Help and Resource Center
Last updated: September 12, 2016
Give Feedback

ShopSite Shopping Cart Software