Integrating with Braintree by PayPal for eCommerce

Be sure to review our overview of eCommerce Setup guides: Introduction to eCommerce

Note

Academy of Mine does not directly collect payments. In order to collect payments, you will need to sign up with a third party payment gateway, such as Braintree by PayPal, then connect it with the Academy of Mine platform using the API credentials provided by the payment gateway. Before proceeding with this guide, you must sign up for a Braintree by PayPal account.

Braintree by PayPal is an online payment processing platform that allows businesses to send and receive payments over the internet. It is fully integrated into Academy of Mine's checkout process. Payments made in Academy of Mine will be passed on to Braintree for collection.

This guide will help you complete your Braintree integration, set up testing, and ultimately go live to collect real payments. 

In this article

Setting Up the Braintree Integration

1

eCommerce settings can be found in the dashboard at eCommerce > Settings > General

2

eCommerce integrations can be found in the dashboard at eCommerce > Settings > Payment

3

Select Manage in the Braintree section to enter the Braintree Settings page.

(image altered for security purposes)

Create a Title

The title you add will appear on the Payment Details section of your checkout page.

Add Your API Credentials

Warning

Braintree has two sets of API keys, one for testing and one for real payments. You must use the test keys first, and once you are ready for real payments, you will swap the test keys for the live keys.

Braintree's test keys are found in the Sandbox account at sandbox.braintreegateway.com. You must use these before you swap them for the live keys.

1

To begin using your Braintree integration, you'll need to add your Braintree Sandbox API credentials

2

In Braintree, you'll need to collect your Sandbox Authorization Key, Merchant ID, Public Key, and Private Key. These can be found at API > Keys

3

The API Keys section will contain your Public Key, Private Key, and Merchant ID.

(image altered for security purposes)

4

The Tokenization Keys section will contain your Authorization Key.

(image altered for security purposes)

5

Back in Academy of Mine, enter those keys in the Braintree Settings page to complete the integration.

(image altered for security purposes)

Enable Braintree

Before you begin testing in your account, you must enable Braintree. If Braintree is not enabled, your Academy of Mine account will not connect with your Braintree account.

Begin Testing

Warning

You cannot use a live credit card during testing. You must use Braintree's test credit card numbers. View this Braintree testing guide for a list of transaction amounts and credit card numbers to complete your testing.

1

Once you have successfully added your Sandbox API credentials, you are ready to attempt test payments.

2

When checking out and placing an order, it is important that you use a test credit card number provided by Braintree, rather than a live credit card.

For example, when testing a successful transaction with Visa you will use the card number 4111111111111111, a CVC of any 3 digits, and an expiration date of any future date.

Ready for Production

Warning

When using Braintree live API keys, real cards must be used, and real payments will be processed.

Braintree's live API keys are found in your Production account.

If your tests have completed successfully and you are ready to accept real payments, there are several steps to take.

1

In your Braintree, leave your Braintree Sandbox account and get a Production account.  

2

Create an API user with Production API keys. 

3

Get your Production API credentials. You'll need your Production Authorization Key (Tokenization Key), Production Merchant ID, Production Public Key, and Production Private Key. Add those to your Braintree integration settings.

(image altered for security purposes)

4

Update your Production account settings to mirror your old Sandbox account settings.

5

Update your live server configuration to Production values.

6

In your Braintree integration settings, enable the setting for Ready for Production. This is the final safety in place to prevent a real payment. Enabling it will officially turn on real payments.

7

Optional step: test real payments in your Academy of Mine account. Create low value transactions to test, for example a simple Product for $1. You must use a real payment method for these tests. 

Next Step

Up next, you'll learn about creating Products to sell your Courses: