Braintree Integration

Braintree, a PayPal company, provides a full-stack payment platform that combines the best of PayPal with advanced card processing capabilities. It’s ideal for businesses that want both PayPal and direct card processing in one integration.

Features

Payment Methods

Credit/Debit Cards - All major cards
PayPal - Full integration (native)
Venmo - US customers
Apple Pay - iOS devices
Google Pay - Android devices
ACH Direct Debit - US bank transfers

Key Advantages

Single integration for cards and PayPal
Advanced fraud protection (Kount)
Marketplace/platform capabilities
PCI compliance included
Transparent pricing

Configuration

Prerequisites

Braintree account (approved)
Merchant ID and API keys
Gateway credentials
Products configured

Setup Steps

Get API Credentials

Log into Braintree Control Panel
Navigate to Settings → API Keys
Copy your Merchant ID
Copy your Public Key
Copy your Private Key

For sandbox:

Switch to Sandbox mode
Go to Sandbox Control Panel
Get sandbox credentials

Never expose your Private Key. It provides full access to your Braintree account.

Configure in FunnelFox

Go to Project Settings → Payment Providers
Select Braintree
Enter Merchant ID
Enter Public Key
Enter Private Key
Choose environment (Sandbox/Production)
Click Save

Webhook Setup

FunnelFox creates webhooks for:

Transaction settled
Transaction failed
Subscription charged
Subscription cancelled
Dispute opened

Configure in Braintree Control Panel:

Go to Settings → Webhooks
Add webhook URL:

https://api.funnelfox.com/webhooks/braintree/[project-id]

Payment Method Setup

Enable payment methods in Braintree:

PayPal - Automatic (owned by PayPal)
Venmo - Request activation
Apple Pay - Domain verification required
Google Pay - Merchant ID needed

PayPal Through Braintree

Enhanced Integration

Since PayPal owns Braintree:

Seamless PayPal checkout
Unified reporting
Single settlement
Shared fraud tools
Better rates possible

Vault Feature

Store PayPal accounts:

One-click repeat purchases
Subscription support
No re-authentication
Higher conversion rates

Using PayPal through Braintree often provides better features and rates than direct PayPal integration.

Subscription Management

Features

Recurring billing
Add-ons and discounts
Modification support
Basic dunning

Limitations

No pause/resume
Limited proration
Basic retry logic
No deferred benefits

Plan Management

Create plans in Braintree:

Plan ID: premium-monthly
Price: $19.99
Billing Cycle: Monthly
Trial: 7 days (optional)

Drop-in UI

Braintree’s hosted payment form:

Benefits

PCI compliance simplified
Automatic updates
All payment methods included
Mobile optimized
Customizable styling

Customization

Basic styling options:

/* Theme customization */
{
  "input": {
    "fontSize": "16px",
    "color": "#333"
  },
  "button": {
    "backgroundColor": "#your-color"
  }
}

Fraud Protection

Kount Integration

Advanced fraud tools:

Machine learning models
Device fingerprinting
Velocity checks
Custom rules
Risk scoring

Basic Fraud Tools

Included features:

AVS (Address Verification)
CVV verification
Duplicate transaction detection
IP geolocation
Threshold rules

Testing

Sandbox Environment

Comprehensive testing:

Access Sandbox

Go to Sandbox
Use sandbox credentials
Create test customers

Test Cards

Card Number	Result
4111111111111111	Success
4000111111111115	Processor declined
5105105105105100	Success (Mastercard)
378282246310005	Success (Amex)

Test PayPal

Use sandbox PayPal accounts Created in PayPal Developer Dashboard

GraphQL API

Braintree uses modern GraphQL:

Benefits

Precise data fetching
Better performance
Type safety
Single endpoint

Example Query

query GetTransaction($id: ID!) {
  transaction(id: $id) {
    amount
    status
    customer {
      email
    }
  }
}

Marketplace Features

Braintree Marketplace

For platforms and marketplaces:

Split payments
Vendor onboarding
Compliance handling
Disbursement management

Marketplace features require additional approval and setup. Contact Braintree for marketplace applications.

Currency Support

Multi-Currency

Process in 130+ currencies:

Presentment currency
Settlement currency
Automatic conversion
Transparent FX rates

Settlement

Settle in your account currency:

Daily settlement
Consolidated reporting
Single reconciliation
Predictable cash flow

Reporting

Control Panel Reports

Transaction search
Settlement reports
Dispute management
Subscription analytics
Custom reports

API Access

Real-time data
Webhook notifications
GraphQL queries
Batch downloads

Common Issues

Payment methods not showing

PayPal not working

Webhooks failing

GraphQL errors

Fees and Pricing

Standard Pricing

Cards - 2.59% + $0.49
PayPal/Venmo - 3.49% + $0.49
ACH - 0.75% (max $5)

Volume Discounts

Custom rates for high volume
Interchange plus pricing available
Non-profit discounts
Contact sales for quotes

Migration from PayPal

Moving from PayPal to Braintree:

Benefits

Keep PayPal, add cards
Better rates possible
More payment methods
Advanced features
Single integration

Process

Apply for Braintree

Approval usually quick for PayPal users

Import customers

Vault existing PayPal accounts

Update integration

Switch to Braintree in FunnelFox

Monitor performance

Track approval rates and costs

Best Practices

Optimization

Enable all payment methods
Use vault for returning customers
Implement fraud tools wisely
Monitor approval rates

User Experience

Show all payment options
Clear security messaging
Fast checkout flow
Mobile-first design

Technical

Use Drop-in UI for simplicity
Implement proper error handling
Log all transactions
Monitor webhook health

Limitations

Compared to Stripe

Fewer Features

Less subscription flexibility
Basic international support
Limited customization
Fewer integrations

Developer Experience

More complex API
Less documentation
Fewer libraries
Slower updates

Geographic Coverage

Strong in:

United States
United Kingdom
Europe
Australia

Limited in:

Asia
Africa
Latin America

Next Steps

Configure checkout element with Braintree
Set up PayPal in Braintree
Test integration in sandbox
Enable fraud protection features

Getting started

Dashboard

Editor

Integrations

​Features

​Payment Methods

​Key Advantages

​Configuration

​Prerequisites

​Setup Steps

​PayPal Through Braintree

​Enhanced Integration

​Vault Feature

​Subscription Management

​Features

​Limitations

​Plan Management

​Drop-in UI

​Benefits

​Customization

​Fraud Protection

​Kount Integration

​Basic Fraud Tools

​Testing

​Sandbox Environment

​GraphQL API

​Benefits

​Example Query

​Marketplace Features

​Braintree Marketplace

​Currency Support

​Multi-Currency

​Settlement

​Reporting

​Control Panel Reports

​API Access

​Common Issues

​Fees and Pricing

​Standard Pricing

​Volume Discounts

​Migration from PayPal

​Benefits

​Process

​Best Practices

​Optimization

​User Experience

​Technical

​Limitations

​Compared to Stripe

​Geographic Coverage

​Next Steps

Features

Payment Methods

Key Advantages

Configuration

Prerequisites

Setup Steps

PayPal Through Braintree

Enhanced Integration

Vault Feature

Subscription Management

Features

Limitations

Plan Management

Drop-in UI

Benefits

Customization

Fraud Protection

Kount Integration

Basic Fraud Tools

Testing

Sandbox Environment

GraphQL API

Benefits

Example Query

Marketplace Features

Braintree Marketplace

Currency Support

Multi-Currency

Settlement

Reporting

Control Panel Reports

API Access

Common Issues

Fees and Pricing

Standard Pricing

Volume Discounts

Migration from PayPal

Benefits

Process

Best Practices

Optimization

User Experience

Technical

Limitations

Compared to Stripe

Geographic Coverage

Next Steps