The Braintree payment gateway will allow your attendees/registrants to pay for their event registration with a credit card, debit card, or even through PayPal.
View quick links for this payment gateway –>
Installation
This payment gateway is a plugin for WordPress and can be installed through your WP dashboard (WP-admin).
Download the latest version of the Braintree payment gateway for Event Espresso 4 from your Event Espresso account.
Then login to your WordPress dashboard (WP-admin) and go to Plugins. Next, click on Add New –> Upload and browse to the plugin on your computer. Then select the zip file and begin the upload process. Wait for the plugin to upload and then click on Activate.
Locate your Credentials for Braintree
Your credentials for Braintree can be found in your Braintree merchant account. Here are the steps to find your credentials for Braintree:
1) Log in to your production account on Braintreegateway.com.
2) Click on Account in the top right area of the screen.
3) Click My User.
4) Scroll down and click on View API Keys under the Authorization section.
5) Existing API keys will be visible,c and you can click on one to view more information. If you do not see any, then click on Generate New and a new set of API Keys will be created, and the page will refresh.
Click on the new API key and then copy the Public Key, Private Key, and Merchant ID into your payment settings screen for Event Espresso and then save changes.
Want to test Braintree before accepting payments in live / production mode?
Follow the steps above and select Sandbox in step 1. That will take you to the sandbox site where you’ll be able to retrieve your credentials. Be sure that debug mode is turned on in the payment method settings screen for Braintree for Event Espresso. Once you are finished testing, it is important to turn debug mode off and re-enter your production / live credentials and save changes.
Will Braintree be the only payment method enabled or the only one you offer?
Click here to learn how to make it selected by default during the registration checkout.
Setup and Configuration
A Braintree account is needed to accept payments via Braintree. Need an account? Sign-up for a Braintree merchant account to get started.
A dedicated SSL certificate is recommended to make registration checkout and other areas of your website more secure.
Login to your WP-admin (WP Dashboard) and go to Event Espresso –> General Settings –> Payment Methods. Once on the Payment Methods screen, click on Braintree and click on the button to activate the payment method.
Below are the available fields and explanations for each field.
Name – This is the name of the payment method.
Description – This description is shown during registration checkout.
Admin-Only Name – This is a name of the payment method that will only be shown in the WP Dashboard (WP-admin).
Admin-Only Description – This description is used only in the WP Dashboard (WP-admin).
Debug Mode On? – Enables debugging for this payment method. It should be off (set to no) on a live/production site.
Open by Default? – This sets this payment method to be pre-selected on the registration checkout page.
You can offer multiple payment options to your attendees. However, if you have a single payment gateway enabled, then set it to Open by Default for a faster checkout experience for your attendees.
Merchant ID – A unique identifier for your gateway account, which is different than your merchant account ID.
Public key – User-specific public identifier.
Private Key – User-specific secure identifier that should not be shared.
Button URL – This is the URL to the image that will be used during the payment process of registration checkout.
Alternative Button URL: http://ee-screenshots.s3.amazonaws.com/2015/07/pay-by-credit-card.png
Usable From? – Select where this payment method should be available for use. This payment method cannot process payments through the WP-admin (WP Dashboard).
PMD Order – The value (number) can be used to sort or arrange this payment option. A lower value means that it should appear first during registration checkout.
Update Settings – Click this button after making any changes to your payment method.
Deactivate Payment Method – Click this button to deactivate this payment method.
Optional Settings that can be turned On
Located in Europe or outside of the United States? By default, the payment gateway will ask for a full address including a state/province and a zip/postal code.
If you would like to make these optional, then please see this link: https://gist.github.com/lorenzocaum/ea0401828f83826917d4
The changes in the link above are suggested if you will be having registrations where your attendees/registrants may be from a country that does not use a state/province and/or a postal/zip code.
Your Braintree merchant account can accept payments via PayPal and offers CVV which can reduce fraud.
The PayPal setting can be found by logging into your Braintree production account and then clicking on Settings and then Processing. Now scroll down and look for the Accept PayPal option and click on Edit. Enter a URL for your privacy policy and your terms and conditions page on your own website and then click on Submit. Use Vault Flow should remain unchecked.
The CVV setting can be found by logging into your Braintree production account and then clicking on Settings and then Processing. Now scroll down and look for the Basic Credit Card Fraud Tools section and click on Edit under CVV. Place a checkmark next to the first two options and then save changes.
Usage
The Braintree payment gateway will let you accept payments via major credit or debit cards.
This is an onsite payment gateway which means that attendees/registrants will process their payment on your site.
A Braintree account is needed to accept payments via Braintree and an SSL certificate is recommended for securing your website.
Troubleshooting
I’m using an old version of PHP. Can I still use the Braintree payment gateway?
Braintree requires PHP 5.4 or newer and cannot be used with older versions of PHP. This is a requirement from Braintree. Click here to view a sample message that you can share with your web host if you are using an older version of PHP.
I configured Braintree and payments are not being processed. Can you help?
Double-check your credentials to make sure that you are using the production / live credentials which are for production mode. Also, ensure that there is no extra spacing before or after the credentials in the payment methods page of Event Espresso.
Frequently Asked Questions
How can I set up a recurring payment or subscription through Braintree?
Recurring or subscription payments are not currently supported in the EE4 Braintree payment gateway.
When I refund a payment, does it also refund through Braintree?
Refunds in Event Espresso 4 are currently a two-step process.
1) Apply the refund through the transactional details screen of Event Espresso in your WP-admin (WP dashboard).
2) Then login to your Braintree account and process the refund.
Is an SSL certificate needed for Braintree?
A dedicated SSL certificate is recommended if you are accepting payments on your website.
Do I need to be PCI compliant?
Compliance with the Payment Card Industry Data Security Standards (PCI DSS) is required if you are processing, storing, or transmitting credit card data. Event Espresso helps by using Braintree’s Drop-in Payment UI for payment processing and recommends using a dedicated SSL certificate on your website.
View more information on PCI compliance from Braintree.
Customizations
Our support team cannot write custom coding for you. Below are some examples on customizing this payment gateway.