Connect to Braintree

This guide outlines the necessary steps to connect your Pagos and Braintree accounts. For more information on connecting Pagos to other payment processors, see our Connect to Adyen and Connect to Stripe guides.

Step 1 - Create a Limited Access Role in Your Braintree Account

For added security of your data, we recommend that you log into your Braintree admin account and create a limited access API key for use with Peacock:

  1. Log into your Braintree production environment as an admin and create a new role. Name it something specific to its use, like Peacock Dashboard.
  2. Under Rights Granted for this new role, enable only the following permissions:
    • Transactions
      • Download Transactions with Masked Payment Data
    • Reporting
      • Create, Run, and Download Reportrs
      • View Dashboard Graphs
    • Recurring Billing
      • Download Subscription Records
      • View Modifications
      • View Subscription Plans
      • View Subscriptions
      • Search Subscriptions
    • Dispute Management
      • View, manage and contest disputes
    • Webhooks
      • Manage Webhooks (Add/Edit/Delete)
    • Read-Only Access
      • View Address
      • View Customers
      • View Merchant Accounts
      • View Payment Methods
      • View Transactions
      • View Verifications
      • Download Files
    • Search
      • Search Customers
      • Search Transactions
      • Search Verifications
  3. Click Create Role.

Step 2 - Create an API User in Your Braintree Account

After you create a limited access role, create an API user in your Braintree dashboard:

  1. Create a new user.
  2. Under API Access, click the checkbox beside API Access.
  3. Under Roles, click the checkbox beside your new limited access role.
  4. Under Merchant Accounts click the checkbox beside all of the merchant accounts for which you want data to flow to Peacock.
  5. Click Create User.
  6. Log out of your admin account, then log back in as your read-only user account.
  7. Locate and save the following values for future use:

Step 3 - Add a New Data Source to Your Pagos Account

To pull in Braintree data to Pagos, you'll need to add a new data source in your Pagos account:

  1. Log into your Pagos account.
  2. Click the Pagos logo in the top right corner, then click Pagos Account.
  3. Click Data Sources.
  4. To add a new data source, click + Add new data source.
  5. In the right-side panel that opens, click Braintree, then fill in the following fields using the saved values from Step 2:
    • Name - This value is used for display and identification on charts, and can be whatever you prefer
    • Merchant ID
    • Public Key
    • Private Key
  6. Click Add.

Step 4 - Create a Webhook

After you enter your Braintree details in the Data Sources tab of your Pagos account and click Add, a pop-up will prompt you to create a webhook. Click Copy beside the destination URL, then click Ok.

Next, log into your Braintree limited access user account to create a webhook.

On the New Webhook screen:

  • Paste the destination URL you copied from your Pagos account into the Destination URL field
  • Under Notifications, click the checkbox beside each notification event option.

What’s Next
Did this page help you?