Table of Contents
- Braintree Payments
- US, AU, CA, AL, AD, AM, AT, BY, BE, BA, BG, CH, CY, CZ, DE, DK, EE, ES, FO, FI, FR, GB, GE, GI, GR, HU, HR, IE, IS, IT, LT, LU, LV, MC, MK, MT, NO, NL, PL, PT, RO, SE, SI, SK, SM, TR, VA
Setting Up Braintree Payments for FoxyCart
Log in to the Braintree Payments admin and click the
Settings dropdown. Select
Users and roles and then click your user. Alternately, you can create an API user if you prefer. Once you have clicked the user account you wish to use, click the
API Keys link under the
Authorization heading. On this page you'll need to get your
Merchant ID as well as your
Public and Private Keys. Load this information into the FoxyCart admin.
Subscriptions and Braintree
Braintree is compatible with FoxyCart's subscription functionality.
FoxyCart by default requires the CVV to be entered on all new cards (and, by default, when a customer uses a saved card as well). When the customer is initially purchasing the subscription, they'll need to enter the CVV as part of the checkout. When the subscription renews automatically though, the CVV/CSC is not passed to the gateway as we're not able to store that information due to PCI compliance. This means that depending on your settings in Braintree, it could cause the renewal to fail because of a missing CVV/CSC.
To ensure that subscription renewals can be processed successfully you should set your CSC (CVV) rules with the
U rules checked in the “Edit CVV Rules” page shown below, ensuring the
I rule is not checked.
Braintree Fraud Detection
Foxy's integration with Braintree supports their native fraud detection functionality, enabled by default. It also supports their custom Kount integration, which you can enable by selecting “Kount (Advanced)” from the “gateway fraud detection” dropdown in the Braintree settings on the “payment” page of the Foxy admin. Note that enabling Kount also comes with additional requirements for your Braintree account, which you can see details of here.
Obtaining a Test Account
You can create a Sandbox Account to setup a testing account.
Test Card Numbers
Please see https://www.braintreepayments.com/docs/ruby/reference/sandbox for testing numbers to be used in the sandbox environment. The easiest number to use is the standard
Troubleshooting & Interpreting Response Codes
Details about the response codes can be seen at https://www.braintreepayments.com/docs/php/transactions/overview
Important Notes and Caveats
User Notes and Experiences
If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.