Braintree

Setting up Braintree

1. 1

   Log in to the Braintree admin and click the Settings dropdown.

2. 2

   Select Users and roles, then click your user. You can create a dedicated API user instead if you prefer.

3. 3

   Click API Keys under the Authorization heading.

4. 4

   From this page you'll need your Merchant ID, Public Key and Private Key.

5. 5

   Go to the Foxy admin and go to Settings > Payments.

6. 6

   Open or create a payment method set, then click Add payment method + and choose Braintree.

7. 7

   Under Live setup, enter your Merchant ID, Public Key and Private Key. This setup only takes effect once Use live credentials is turned on for the payment method set.

8. 8

   Under Test setup, enter the credentials from your Braintree sandbox account.

9. 9

   Optionally set Merchant Account ID (optional) if you need to target a specific Braintree merchant account. See Multi-currency below.

10. 10

    Set 3D Secure and Card verification to suit your account.

11. 11

    Click Create, or Save if you're editing an existing entry.

Subscriptions and Braintree

Braintree is compatible with Foxy's subscription functionality.

Foxy 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 initially purchases the subscription they'll enter the CVV as part of the checkout. When the subscription renews automatically, the CVV/CSC is not passed to the gateway, because we can't store that information under PCI compliance. Depending on your settings in Braintree, that can cause the renewal to fail for a missing CVV/CSC.

To make sure subscription renewals process successfully, set your CSC (CVV) rules with the N and U rules checked on the Edit CVV Rules page shown below, and make sure the I rule is not checked.

Braintree fraud detection

Foxy's integration with Braintree supports their native fraud detection, enabled by default. It also supports their custom Kount integration, which you can enable by selecting Kount (Advanced) from the Gateway Fraud Detection dropdown on the Braintree entry in your payment method set.

Enabling Kount comes with additional requirements for your Braintree account.

Testing

Obtaining a test account

You can create a Sandbox Account to set up a testing account.

Test card numbers

See Braintree's testing documentation for testing numbers to use 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 in Braintree's result objects documentation.

Authentication error

If you get an authentication error response on your store with Braintree, first check that the credentials you entered into Foxy exactly match the credentials in the Braintree administration.

If they match exactly, the other likely cause is the IP restrictions configured on your Braintree account. You may need to contact Braintree support to review this on your account and see whether it's affecting your connection.

Important notes and caveats

Multi-currency

Braintree supports one currency per account. If you need to accept multiple currencies, set up a merchant account ID for each currency in Braintree, then use a different Foxy payment method set for each one, entering the matching Merchant Account ID (optional) value on the Braintree entry in each set.

See our documentation on payment sets for more on managing multiple sets.