This is an old revision of the document!


type:
gateway
name:
Braintree Payments
countrie:
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
support-added:
1.1
auth-net-emulation:
no
supports-3dsecure:
no
gateway:
https://www.braintreepayments.com/

Braintree Payments

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.

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

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.

Site Tools