Braintree

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 N and 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.

Testing

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 4111-1111-1111-1111.

Troubleshooting & Interpreting Response Codes

Details about the response codes can be seen at https://www.braintreepayments.com/docs/php/transactions/overview