Setting Up Braintree As Your Payment Gateway for Core Registration

How to add Braintree as a payment gateway for Core Registration.

Table of Contents

Finding Your API Keys in Braintree

API keys from your Braintree account must be created and entered into your Experience organization to connect your payment gateway and your Core Registration site(s). The instructions below outline how to generate API keys from your Braintree account.

  • Click on the gear icon at the top right of your Braintree account. 
  • Choose API from the dropdown menu. 
  • Select Generate New API Key and click View when the new key has been generated. 

SCR-20250430-pdhg

  • Take note of the Public Key, Private Key, and Merchant ID. 

SCR-20250430-phsc

Connecting Braintree to EventMobi

When you have your Braintree API Keys, the next step is to input them into your organization to connect your payment gateway to your events. The instructions below outline how to save your API keys to your Experience organization. 

  • Select Payment Gateways from the menu of your Experience Organization.
  • Click on Add Connection.
  •  Input a Name to represent your payment gateway. 
  • Choose Braintree from the Gateway field.
  • Paste in your Merchant ID from Braintree. 
  • Paste your Public Key and Private Key into their respective fields.
  • Select Add Connection to save your update. 
  • Use the Events dropdown menu to connect your Braintree account to any events with Core Registration enabled, or select Skip, I'll do it later
  • Reference the Status area to confirm your payment gateway is Active

Screenshot 2025-04-30 at 5.32.18 PM

 

  • Select Add Connection to save your update. 
  • Use the Events dropdown menu to connect your Braintree account to any events with Core Registration enabled, or select Skip, I'll do it later
  • Refer to the Status area to confirm that your payment gateway is Active

See an Inactive Status?  Check the status of your credentials using the Check Status option in the Experience platform. If the status remains Inactive, you can try updating the status again later, or you will need to create a new gateway and repeat the steps above.

How To Test Your Payment Gateway

An actual payment must be processed to test your payment gateway. We recommend creating a ticket with a small fee (example: $1.00) that you can test, and then complete a registration with a credit card. 

Once the registration payment has been processed, you can initiate a refund from your payment gateway. 

Managing Payments and Refunds with Braintree

All refunds for registration fees must be processed directly from your Braintree account. The instructions below outline how to view transaction records and process refunds.

  • Click on Transactions at the top of your Braintree account. 
  • Use the Transaction Search to locate the transaction you're refunding, and then click on the corresponding Transaction ID
  • Select Refund and input the amount you want to refund. 
  • ClickRefund to complete the process. 

Screenshot 2025-04-30 at 5.44.17 PM

Understanding Braintree's Response Codes

Braintree uses response codes to indicate the status of a request. You can find a detailed list on Braintree's Support page, but some response codes to take note of are: 

  • 2000: The user's bank has prevented the payment from processing.
  • 2005: The credit card number is invalid. 
  • 2006: The credit card expiry date is invalid. 

How To Access Braintree's Support

You can access additional resources and support related to your payment gateway account from Braintree's Support Center