PayPal payment integration

PayPal integration enables you to accept payments from millions of PayPal users worldwide. With strong brand recognition and buyer protection, PayPal can significantly increase conversion rates for certain demographics and regions.

Features

Payment Methods

PayPal Wallet - Direct PayPal account payments
PayPal Credit - Buy now, pay later (US)
Venmo - Popular with younger US demographics
Guest Checkout - Cards without PayPal account

Subscription Features

Basic recurring billing
Subscription plans
Plan switching (upgrades/downgrades)
Cancellation management

Key Benefits

Trusted by consumers globally
One-click payments for returning users
Buyer and seller protection
No card details shared with merchant

Configuration

Prerequisites

PayPal Business account
API credentials (Client ID and Secret)
Webhooks enabled
Products/plans created in PayPal

Setup Steps

Get API Credentials

Log into PayPal Developer Dashboard
Navigate to My Apps & Credentials
Select or create an app
Copy Client ID
Copy Secret (click Show)

For sandbox testing:

Switch to Sandbox tab
Use sandbox credentials
Create test accounts for testing

Keep your Secret key secure. Never expose it in client-side code or public repositories.

Configure in FunnelFox

Go to Integrations → PayPal
Select PayPal
Enter Client ID
Enter Secret
Choose environment (Sandbox/Live)
Click Save

Webhook Configuration

FunnelFox automatically registers webhooks for:

Payment capture completed
Subscription activated
Subscription cancelled
Subscription suspended
Payment sale completed

Webhook URL created:

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

Product Setup

For subscriptions, create plans in PayPal:

Go to PayPal Dashboard
Click Create Plan
Set pricing and billing cycle
Activate the plan
Plans sync to FunnelFox automatically

Subscription Management

Creating Plans

In PayPal Dashboard:

Plan Name: Premium Monthly
Price: $19.99/month
Billing Cycle: Monthly
Trial: Optional (set days and price)
Setup Fee: Optional

Subscription Limitations

PayPal subscriptions have limitations compared to other PSPs:

No pause/resume - Only cancel is supported
No deferred benefits - Unused time is lost
Limited trials - Basic trial support only
Plan changes - Require cancellation and new subscription

Managing Subscriptions

Available operations:

Cancel - Immediate or at period end
Suspend - Temporarily stop charging
Reactivate - Resume suspended subscription
Update - Limited to payment method

Checkout Experience

PayPal Button

The familiar PayPal button:

Instantly recognized
Builds trust
One-click for returning users
Opens PayPal login window

Guest Checkout

Allow non-PayPal users:

Pay with credit/debit cards
No PayPal account required
Still processed by PayPal
Optional - can be disabled

Guest checkout availability varies by country and buyer’s purchase history. PayPal determines eligibility automatically.

Express Checkout

Speed up purchases with PayPal One Touch:

User logs into PayPal once
Stays logged in across sites
One-click purchases thereafter
No password on each purchase

Dramatically increases conversion for repeat buyers.

Testing

Sandbox Environment

Test with sandbox accounts:

Create Test Accounts

Go to PayPal Developer
Create buyer account (personal)
Create seller account (business)
Note email and password for each

Test Payments

Use sandbox credentials in FunnelFox
Log in with test buyer account
Complete purchase flow
Check sandbox notifications

Test Scenarios

Test these flows:

Successful payment
Cancelled payment (close PayPal window)
Insufficient funds
Subscription creation
Subscription cancellation

Regional Considerations

Strong Markets

PayPal is particularly popular in:

United States - 50%+ have accounts
United Kingdom - Widely trusted
Germany - Preferred payment method
Australia - High adoption rate

Payment Methods by Country

Country	PayPal Credit	Venmo	Guest Checkout
US	✅	✅	✅
UK	❌	❌	✅
Germany	❌	❌	✅
Australia	❌	❌	✅

Integration Methods

Direct Integration

Using PayPal directly:

Full PayPal features
Direct relationship
PayPal fees apply
Separate reconciliation

Via Other PSPs

PayPal through other providers:

Stripe - Available for EU accounts
FunnelFox Billing - Unified management

If you’re already using Stripe (EU), you might not need separate PayPal integration. Check your existing PSP’s PayPal support.

Fees and Pricing

PayPal transaction fees:

Domestic - 2.9% + $0.30 (US)
International - 4.4% + fixed fee
Micropayments - 5% + $0.05 (under$ 10)
Nonprofit - Discounted rates available

No monthly fees for standard accounts.

Common Issues

PayPal button not showing

Verify Client ID is correct
Check JavaScript isn’t blocked
Ensure HTTPS is enabled
Clear browser cache

Guest checkout not available

Not available in all countries
Buyer history affects availability
Can be disabled by PayPal
Try different test account

Webhooks not received

Check webhook URL in PayPal
Verify webhook ID is correct
Ensure endpoint is accessible
Review PayPal webhook logs

Subscription plans not syncing

Plans must be active in PayPal
Check API permissions
Verify billing agreement enabled
Wait up to 5 minutes for sync

Optimization Tips

Increase Conversions

Show PayPal prominently - Many users look for it
Enable guest checkout - Don’t force PayPal accounts
Use Express Checkout - Reduce friction
Display buyer protection - Build trust

Reduce Abandonment

Clear PayPal fees disclosure
Show security badges
Explain redirect to PayPal
Provide customer support

Mobile Optimization

PayPal optimized for mobile
In-context checkout available
Biometric authentication
Saved payment methods

Limitations

Compared to Card Processing

Less Control

Redirects to PayPal
Limited checkout customization
PayPal branding required
Can’t fully white-label

Fewer Features

Basic subscription management
Limited retry logic
No advanced dunning
Minimal analytics

Customer Ownership

PayPal owns relationship
Limited customer data
PayPal handles disputes
Restricted email access

Best Practices

Positioning

Offer alongside cards, not instead
Highlight for international customers
Emphasize buyer protection
Show for returning customers

Communication

Explain PayPal redirect
Set clear expectations
Provide PayPal support info
Handle disputes promptly

Technical

Always use HTTPS
Implement proper error handling
Log all transactions
Monitor webhook failures

Getting started

Dashboard

Editor

Integrations

Documentation Index

​Features

​Payment Methods

​Subscription Features

​Key Benefits

​Configuration

​Prerequisites

​Setup Steps

​Subscription Management

​Creating Plans

​Subscription Limitations

​Managing Subscriptions

​Checkout Experience

​PayPal Button

​Guest Checkout

​Express Checkout

​Testing

​Sandbox Environment

​Test Scenarios

​Regional Considerations

​Strong Markets

​Payment Methods by Country

​Integration Methods

​Direct Integration

​Via Other PSPs

​Fees and Pricing

​Common Issues

​Optimization Tips

​Increase Conversions

​Reduce Abandonment

​Mobile Optimization

​Limitations

​Compared to Card Processing

​Best Practices

​Positioning

​Communication

​Technical

​Next Steps

Features

Payment Methods

Subscription Features

Key Benefits

Configuration

Prerequisites

Setup Steps

Subscription Management

Creating Plans

Subscription Limitations

Managing Subscriptions

Checkout Experience

PayPal Button

Guest Checkout

Express Checkout

Testing

Sandbox Environment

Test Scenarios

Regional Considerations

Strong Markets

Payment Methods by Country

Integration Methods

Direct Integration

Via Other PSPs

Fees and Pricing

Common Issues

Optimization Tips

Increase Conversions

Reduce Abandonment

Mobile Optimization

Limitations

Compared to Card Processing

Best Practices

Positioning

Communication

Technical

Next Steps