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.

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.

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.

You can create a Sandbox Account to setup a testing account.

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.

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

Braintree supports one currency per account, so if you need to accept multiple currencies, you'll need to set up merchant account ID for each currency, and use different Foxy payment sets for each currency. Braintree's information about Multicurrency is in their docs here.

Our documentation on payment sets is here.

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.